Формат справки WinHelp

Стандартное окно справочной службы имеет структуру показанную на рисунке 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.