3.2. Задание названия раздела

Название раздела используется в справочной службе следующим образом:

• оно появляется после активизации пункта Закладка главного меню справочной службы;

• оно указывается в списке разделов диалоговых окон, связанных с кнопками Поиск и Хронология инструментальной панели справочного окна.

На рис. 91 показана вкладка Поиск окна справочной службы Delphi.

Название раздела задается с помощью сноски $, которая должна предшествовать первому символу текста раздела. На рис. 92 показан пример окна Word с названием Режим Отладка для раздела Отладочным режим. Название раздела записывается в тексте сноски и отделяется от символа $ одним пробелом. В тексте названия можно указывать любые символы, в том числе и пробелы. Максимальная длина названия — 255 символов. Обычно название раздела совпадает с его заголовком.

Рис. 91. Вкладка Поиск со списком названий найденных разделов

Рис. 92. Вставка названия раздела

3.3. Определение ключевых слов

Справочная служба позволяет искать разделы по связанным с ними ключевым словам. На вкладке Поиск (см. рис. 32) предусмотрены возможности ввода ключевых слов в поле (1) и выбора их в списке (2). Для любого раздела можно назначить сколько угодно ключевых слов и, наоборот, с любым ключевым словом можно связать сколько угодно разделов.

Для определения ключевого слова в начале раздела (до первого символа текста раздела) ставится сноска в виде латинской буквы К или k. Например:

К открыть: текст файл;ASCII;текст

Все связанные с разделом ключевые слова помещаются в текст сноски и отделяются от К одним пробелом, а друг от друга символом точки с запятой (;). Группы связанных по смыслу ключевых слов объединяются во фразы, которые отделяются друг от друга пробелами. Справочная служба ищет и отображает в списке названия всех разделов, ключевые слова которых перечислены в одной фразе. Например, если для приведенной выше сноски пользователь ввел слово файл, будут представлены названия разделов, связанных со словами файл, ASCII и текст.

Помимо основной таблицы ключевых слов в справочной службе может быть определена дополнительная таблица. Слова из дополнительной таблицы не выводятся на вкладке Поиск. Их использование возможно только в макрокомандах ALink и TestALink (см. ниже раздел «Макрокоманды WinHelp»). Для вставки ключевых слов в дополнительную таблицу используется сноска в виде латинской буквы А:

3.4. Определение условий компиляции

Подобно директивам условной компиляции Delphi, в RTF-файл можно вставлять указания Help-компилятору помещать или не помещать в результирующий файл тот или иной раздел. Такие указания могут понадобиться на этапе отладки справочной службы, а также при создании нескольких версий приложения (например, справочная служба демонстрационной версии может не содержать некоторые разделы, определенные для основной версии). Они вставляются в текст с помощью сноски *. Чтобы включить условный раздел в Help-файл или исключить его из файла, ключевое слово, определяемое сноской *, должно указываться в секции соответственно [INCLUDE] или [EXCLUDE] файла проекта справочной службы (см. ниже раздел «Разработка проектного файла»).

В тексте сноски * можно указать одно или несколько управляющих слов (следующие друг за другом слова в тексте сноски разделяются символом ;). Раздел будет включен в Help-файл, если хотя бы одно из связанных с ним управляющих слов указано в секции [INCLUDE] файла проекта (если раздел не имеет сноски *, он всегда включается в результирующий файл). Управляющие слова могут содержать любые символы, кроме ; и пробелов. Например:

* Test Build: AppVersionl; DebuggVer