Сохранить и откомпилировать проект

Перед тем как двигаться дальше, необходимо сохранить проект и файл содержания. Для этого можно нажать кнопку Save and Compile в нижней части диалогового окна проекта.

Компилятор справки обрабатывает файлы разделов, содержания и проекта. Результаты отображаются в окне. Если компиляция прошла без ошибок, можно переходить к тестированию справочного файла.

21. Создайте следующие сноски:

# IDH_Compile

$ Сохранить и откомпилировать проект

+ auto

22. Введите текст следующего раздела:

Протестировать полученный справочный файл

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

Когда все будет работать нормально, справочный файл можно подключать к приложению.

23. Создайте следующие сноски:

# IDH_Test

$ Протестировать полученный справочный файл

+ auto

Вы только что создали свой первый файл разделов. Помните — это был обычный файл, который лишь показывает общую схему действий. После того как вы введете все разделы и сноски, этот процесс надолго останется в вашей памяти. Как известно, практика — лучший учитель. Давайте перейдем к последней стадии работы над справочным файлом — созданию файла проекта.

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

Чтобы связать воедино файлы содержания и разделов, необходимо создать файл проекта:

1. Если Help Workshop не был открыт, запустите его.

2. Создайте новый файл проекта командой File > New. Выберите строку Help Project и нажмите кнопку ОК.

3. Когда Help Workshop предложит задать имя проекта, введите строку Skill13 и нажмите кнопку Save. Примерный вид окна Help Workshop показан на рис. 13.5.

Рис. 13.5. Новый файл проекта

4. Откройте диалоговое окно Options с помощью одноименной кнопки.

5. В диалоговом окне Open введите строку Создание справочного файла в поле Help Title.

6. Перейдите на вкладку Compression. Установите переключатель Custom, а затем -флажок Hall Compression.

7. Перейдите на вкладку Files и введите в поле Help File строку Skill13. hlp.

8. Нажмите кнопку Change рядом с полем RTF Files.

9. Когда откроется диалоговое окно Topic Files, нажмите кнопку Add. Выберите файл Skill13.rtf. Файл разделов добавляется в проект. Нажмите кнопку Open.

10. Если файл Skill13.rtf присутствует в списке Topic Files, закройте диалоговое окно кнопкой ОК.

11. Нажмите кнопку Browse рядом с полем Contents. Выберите в диалоговом окне файл Skill13.cnt. Созданный ранее файл содержания включается в проект.

12. Закройте диалоговое окно Options кнопкой ОК.

Обратите внимание на то, что некоторые вкладки диалогового окна Options нами не использовались (рис. 13.6). Более подробную информацию о параметрах, расположенных на этих вкладках, можно получить в справочной системе Help Workshop.

Рис. 13.6. Диалоговое окно Options

13. Нажмите кнопку Windows, чтобы вызвать диалоговое окно Window Properties (рис. 13.7).

14. Чтобы увидеть свойства окна, необходимо создать само окно. В диалоговом окне Add New Window Type введите строку Main в поле Create a Window Named. Выберите из списка Based on this Standard Window строку Procedure. Когда настройка параметров будет завершена, нажмите кнопку ОК.

Когда окно будет создано, диалоговое окно Windows Properties принимает вид, изображенный на рис. 13.7.

15. Нажмите кнопку Buttons и установите флажок Browse. В справочном окне создаются кнопки просмотра. Не изменяйте состояния остальных флажков.

Рис. 13.7. Диалоговое окно Window Properties

16. Закройте диалоговое окно Window Properties кнопкой ОК. Справочный проект должен выглядеть так, как показано на рис. 13.8.

Рис. 13.8. Файл проекта

17. Нажмите кнопку Map. В этом диалоговом окне мы сделаем нашу справочную систему контекстно-зависимой.

18. Для каждого из разделов, перечисленных ниже, нажмите кнопку Add и введите соответствующий идентификатор в поле Topic ID, а также идентификатор контекста в поле Mapped Numeric Value.

Идентификатор раздела	Идентификатор контекста
IDH_CreateContentsFile
IDH_AddHeadings
IDH_AddTopics
IDH_WriteTopics
IDH_AddFootnotes
IDH_SaveRTF
IDH_CreateProjectFile
IDH_SetOptions
IDH_AddFiles
IDH_DefineWindow
IDH_Compile
IDH_Test

19. После ввода всех значений закройте диалоговое окно кнопкой ОК.

20. Нажмите кнопку Save and Compile. Во время компиляции окно Workshop сворачивается. Если все прошло нормально, окно восстанавливается и в нем отображаются результаты компиляции (рис. 13.9).

Рис. 13.9. Результаты компиляции для файла проекта

Справочный файл следует немедленно протестировать, чтобы убедиться, что он работает нормально. Для этого выполните следующие действия:

1. Нажмите кнопку Help (желтый вопросительный знак) на панели инструментов.

2. Когда на экране появится диалоговое окно View Help File, в нем должно быть заранее указано имя файла Skill13.hlp. Если его там нет, нажмите кнопку Browse и выберите файл Skill13.hip. После того как файл будет выделен, нажмите кнопку View Help.

3. На вкладке Contents попробуйте развернуть заголовки — вы увидите, как выглядит ваш справочный файл. Щелкайте на отдельных разделах, чтобы просмотреть их.

Вот и все, что требуется сделать для создания простейшего справочного файла. Теперь у вас есть краткое изложение этого урока, оформленное в виде справочного файла. Откройте его, если вам потребуется создать текстовый файл в будущем. Любители острых ощущений могут дополнить файл разделов и внести в него сведения о ссылках и работе с графикой. Если бы я попытался рассмотреть все возможности и приемы, используемые при создании сложных справочных файлов, пришлось бы писать отдельную книгу. Дальше вам придется действовать самостоятельно.

ПОДСКАЗКАОбязательно просмотрите электронную документацию по Help Workshop — в нее включены подробные инструкции по реализации других возможностей справочной системы Windows.