Стандартное окно справочной службы имеет структуру показанную на рисунке 8.1.
Содержание – оглавление справочного файла.
Предметный указатель – поиск по ключевым словам и фразам.
Поиск – контекстный поиск информации в справочном файле.
Исходный текст справочного файла должен быть написан в формате RTF по определенным правилам:
Формируется оглавление.
Создаются тематические разделы справки.
При написании текста справочного файла используются специальные обозначения:
$ – Название темы.
# – идентификатор темы.
K – ключевые слова и фразы темы.
Для выполнения гипертекстовых переходов выполняют специальное оформление точек перехода. Например
Подчеркивание и пунктирная линии определяют переход на всплывающее окно.
Двойная линия, пунктир определяют переход на другую тему справочного файла, за которым указывается идентификатор точки перехода, символ переадресации и ключевое слово main(имя системного окна Windows).
Информация о темах располагается в виде сноски исходного текста справки.
Рис.8.1. Типовое окно справки
Рис.8.2.Структура RTF файла
Пример организации сноски:
# idTopic 1
$ Тема 1
K API;Winhelp
# ipTopic2
$ Тема 2
K Гипертекстовый переход
# idTopic3
$ Тема 3
K Вторая тема
# idInfo
$ Информация
# idTopic4
$ Тема 4
K Третья тема
Пример структуры файла оглавления:
:Base test.HLP
:Title ТестWinHelp
1 Глава 1
2 О программе=idTopic 1
2 Тема 1=ipTopic2
1 Глава 2
2 Тема 2=idTopic3
2 Тема 3=idTopic4
Файл содержания хранит информацию об имени справочного файла, текст заголовка для окна WinHelp, наименование глав, имена тем и их идентификаторы. Цифры отражают структуру расположения информации(вложенность).
Хранится оглавление в файле с расширением CNT.
Исходный текст справки компилируется и создается файл с расширением HLP, пригодный для просмотра подсистемой WinHelp.