Разработка справочной системы (создание файлов .hip)_______________461

Проекта, Содержания и др. просто в любом текстовом редакторе. Но тогда надо де-
тально изучить их синтаксис. A Help Workshop позволяет автоматизировать всю
работу, не требуя знания синтаксиса, так как эта программа сама создает тексты
файлов, отражающие действия разработчика.

8.3.1 Создание файла Проекта справки

Для компиляции справки и ее связывания с использующим его приложением
необходимо сформировать файл Проекта справки. Это текстовый файл в формате
ASCII. Создание этого файла и отладка справки осуществляется программой Mic-
rosoft Help Workshop, которая распространяется вместе с C++Builder и располо-
жена в каталоге ...\CBuilder4\Help\Tools. Для создания нового файла Проекта,
надо выполнить команду программы Microsoft Help Workshop File New и в появив-
шемся окне New выбрать опцию Help Project. Далее в окне Project File Name надо
задать имя и каталог файла проекта справки. При этом учтите, что то же имя, ка-
кое вы зададите файлу Проекта, будет присвоено компилятором и завершающему
файлу справки .hip (впрочем, это можно отменить, задав другое имя файлу справ-
ки в окне Options на странице Files — это будет рассмотрено позднее). Стандартное
расширение файла Проекта — -hpj.

В результате описанных действий перед вами появится окно заготовки файла
Проекта (рис. 8.6), в котором первоначально будет занесен только раздел [Options].
Теперь, щелкая на соответствующих кнопках в правой части этого окна, можно со-
здавать и заполнять другие разделы файла Проекта. В появляющихся при этом
диалоговых окнах, описанных ниже (см., например, рис. 8.7) справа вверху имеет-
ся кнопка со знаком вопроса. Если нажать ее, возникает изображение вопросите-
льного знака, которое можно подвести к любому элементу окна, после чего всплы-
вет пояснение функции этого элемента.

8.3.1.1 Кнопка Files

Кнопка Files... в правой части окна рис. 8.6 (не путайте с аналогичным по назва-
нию разделом меню) позволяет указать имена файлов с текстами тем. Щелкните
на этой кнопке. Перед вами появится окно Topic Files (рис. 8.7), в котором надо
щелкнуть на кнопке Add... и выбрать среди файлов подготовленный файл текстов
справки. В результате в файле проекта появится раздел [Files] с внесенным в него
именем файла (см. рис. 8.6). Если ваша справка компилируется из нескольких
файлов тем, то аналогичным образом вы должны включить в раздел [Files] и осталь-
ные файлы.

Рис. 8.6

Окно редактирования
файла Проекта справки