454 Глава 8

Рис. 8.4

Окно «Найденные разделы» справочной системы

этом окне конкретные темы задаются в кадрах с помощью сносок с символом $.
Таким образом, сноски $ имеет смысл включать только в те кадры, которые в сво-
их сносках К имеют элементы, используемые также в сносках К других кадров.

8.2.2.4 Сноска А

Сноска А (заглавная латинская буква) аналогична по синтаксису сноске К. Но
ее тексты не включаются в указатель, как для сноски К, а используются только для
переходов по ключевым словам с помощью макроса ALink. Таким образом, если
тексты сносок К участвуют в двух различных процессах — поиске по указателю к
поиске по ключевым словам, то сноски А позволяют развязать эти два процесса.

Хороший стиль программирования

Включайте в ваши темы сноски А. Они позволяют развязать процессы поиска по указателям
и по ключевым словам. Это позволяет вам задавать в сносках К развернутые пояснения
удобные пользователю при работе с предметным указателем.

8.2.2.5 Сноска +

Сноска с символом + используется для указания последовательности просмот-
ра тем с помощью кнопок «»» и ««». Эти сноски имеют смысл только в случаях,
когда вы включаете в окно справки соответствующие кнопки просмотра (кнопки
Browse, включаются в файле Проекта — см. раздел 8.3.1). Если сноски + есть, нов
них не указано никаких значений, то Help Workshop устанавливает автоматиче-
ски последовательность просмотра в соответствии с последовательностью тем в ва-
шем файле. В кадрах, в которых сносок + нет, кнопки просмотра не доступны
Тексты сносок могут быть просто номерами (рекомендуется обозначать их с пред
шествующими нулями: 001, 002 и т.д.) или идентификаторами.

8.2.2.6 Сноска !

Сноска с символом ! используется для указания одного или нескольких макро-
сов, которые должны сработать перед появлением окна данной темы на экране.
Если указывается несколько макросов, то они разделяются запятыми или точками
с запятой. Эти сноски используются только в достаточно сложных справках. По
дробнее о макросах см. в разделе 8.2.4.

8.2.2.7 Сноска *

Сноска с символом * используется для указания связанных друг с другом тем,
которые должны быть встроены в справку. Эти сноски позволяют, подготовив
один файл тем, использовать его для генерации несколько разных файлов справок,
В этом случае в файле проекта .hpj указывается, темы с какими значениями сно-
сок * надо включить в справку — в файл .hip. Темы без сносок * включаются в
справку в любом случае.