16.1Создание файла содержания

Для создания фала содержания необходима программа Microsoft Help Workshop. Она запускается файлом Hcw.exe. Для создания содержания следует:

1. В меню File выбрать команду New. А в окне New указать Help Contents.

2. В поле Default filename (and window): ввести имя файла помощи. Этот файл должен иметь расширение .hlp

3. При помощи кнопок Add Above и Add Below ввести оглавление помощи. В оглавлении могут быть заголовки Heading (для них задаются имена Title) и разделы Topic (для них определяются имена Title и контексты Topic ID). Контекст представляет собой идентификатор раздела. Для обозначения контекста можно использовать русские и латинские буквы, цифры, знак подчеркивания. Контекст начинается с любого символа, в том числе с цифры, а его максимальная длина составляет 255 символов.

4. Файл содержания сохранятся с расширением .cnt

16.2Создание файла разделов

Файл разделов (файл справки) создается как документ в формате RTF. Для его подготовки можно использовать любой редактор, позволяющий работать с документами в этом формате, например Microsoft Word. Документ может содержать графические изображения и таблицы, стилевое и шрифтовое оформление. Основным элементов справочной системы является раздел (страница). Каждый раздел обычно содержит заголовок, отображаемый в верхней части окна просмотра. Раздел имеет атрибуты, задаваемые при помощи сносок (Вставка – Сноска):

# - контекст, идентифицирующий раздел;

$ - заголовок – название, под которым раздел появляется при поиске в окне справки; максимальная длина заголовка 128 символов;

K – список ключевых слов – слова для поиска в окне справки, максимальная длина одного слова составляет 255 символов;

+ - номер в последовательности просмотра – положение раздела при последовательном просмотре справочного файла. Если последовательность не изменяется, то указывается слово auto;

! – макрокоманда – выполняется при отображении раздела;

* - тег компиляции – признак, позволяющий включить или не включать раздел в справочную системы в зависимости от параметров компиляции.

Из всех атрибутов обязательным является контекст.

Отдельные разделы могут связываться друг с другом при помощи ссылок. Ссылку можно выполнить на другой раздел, на раздел в другом справочном файле или временное окно.

Один раздел от другого отделяется разрывом страницы (<Ctrl>+<Enter> или Вставка – Разрыв – Новую страницу).

16.3Создание файла проекта

Файл проекта создается при помощи программы Microsoft Help Workshop. Для создания файла следует:

1. Выбрать команду File – New. В открывшемся окне New выбрать команду Help Project и ввести название проекта (файла помощи). Его имя должно совпадать с тем, которое было указано при создании файла содержания.

2. При помощи кнопки Options:

   1. Во вкладке General вводится заголовок окна помощи (Help title);

   2. Во вкладке Compression выбирается переключатель Custom, а затем устанавливается флажок Hall compression.

   3. Во вкладке Files в поле Help File вводится имя файла помощи. При помощи кнопке Change в поле Rich Text Format files устанавливается ссылка на файл разделов.

   4. Во вкладке Files в поле Contents file устанавливается ссылка на файл содержания.

3. При помощи кнопки Windows задается:

   1. Имя окна справки (Create a window named), а в списке Based on this standard window выбирается Procedure.

   2. На вкладке Buttons диалогового окна Window Properties устанавливается флажок Browse. Остальные флажки не изменяются.

4. При помощи кнопки Map необходимо связать идентификаторы разделов (контексты) с идентификаторами контекста (числом). Это делается щелчком по кнопке Add. Идентификатор контекста используется в коде для отображения на экране справки по соответствующему разделу.

5. По окончании вышеперечисленных действий необходимо нажать кнопку Save and Compile. Во время выполнения этой команды будет создан файл проекта. Теперь следует проверить работу справки.