21.4.1. Секция OPTIONS

Секция [Options] создается или изменяется с помощью кнопки options. Оно содержит общие для всей справочной службы установки и, в частности, определяет умалчиваемую тему, показываемую при открытии HELP-службы, заголовок основного окна, используемый в текстах язык и т. п.

После нажатия кнопки options появляется многостраничное окно, показанное на рис. 21.7.

Рис. 21.6. Окно утилиты Microsoft Help Workshop

Страница General

Default topic - идентификатор умалчиваемого раздела;

Help title - заголовок основного окна справочной службы; замечу, что мне не удалось получить заметных результатов, связанных с изменением этой строки, так что для изменения заголовка основного окна пришлось использовать дополнительное окно main (см. ниже п. 21.4.3); заголовок можно также изменить при создании файла содержания (см. п. 21.5);

Notes - если переключатель выбран, компилятор сообщает о возникающих проблемах, если не выбран - только общее количество предупреждений и ошибок;

Progress - если переключатель выбран, компилятор сообщает о транслируемом -RTF-файле;

Errors - открывает окно для указания кодов ошибок, о которых компилятор не будет сообщать;

Display this text... - определяет текст, который будет помещен

В окно Справка | Версия справочной службы;

Рис. 21.7 . Окно установки параметров секции Options

if users paste... - определяет текст, который будет добавляться в конце копируемой через Clipboard или печатаемой справочной информации.

Страница Compession

Эта страница управляет сжатием результирующего файла.

None - результирующий файл не сжимается;

Maximum - результирующий файл максимально сжимается;

Custom - выбирает алгоритм сжатия результирующего файла.

Страница Sorting

Задает язык и способ сортировки ключевых слов.

Language of Help file - определяет используемый для сортировки ключевых слов язык;

Other - определяет язык сортировки по его индексу;

Non-spacing marks - если переключатель выбран, при сортировке игнорируются кавычки и апострофы; Symbols - если переключатель выбран, при сортировке игнорируются пробелы и знаки препинания; separate index... - содержит перечень символов, которые используются для указания нижних уровней сортировки.

Страница Files

Определяет расположение используемых в проекте файлов и папок.

Help File - имя результирующего нlр-файла; это имя должно быть указано обязательно;

Log File - имя ASCII-текстового файла, в который компилятор будет помещать свою информацию (может не указываться);

RTF-files - определяет имена исходных файлов с текстами справок; замечу, что изменение имен файлов фактически приводит к изменению секции [Files] (см. ниже п. 21.4.2);

contents file - указывает имя файла содержания, если такой файл создан (см. п. 21.5);

тмр folder - определяет папку для хранения временных файлов компилятора;

substitute path prefix - указывает имя маршрута доступа к rtf и вмр-файлам; используется при перемещении этих файлов в другую папку, чтобы не исправлять множество ссылок во всей справочной информации.

Страница FTS

Управляет созданием индекса для быстрого поиска по отдельным словам или фразам справочного текста. Этот индекс создается при первом обращении к окну поиск.

Generate full text search index - Создавать индекс по всем словам справочных фалов;

Include untitled topics in index - включает в индекс разделы без названия;

Enable search for word only - разрешить поиск только по словам;

Enable search for phrase - разрешить поиск по фразам;

Enable display of matching phrase - разрешить поиск по списку выделенных фраз;

Enable search for similar topics - разрешить поиск по альтернативным словам.

Опции этой страницы имеют значение только для сжатых файлов. Переключатели Enable могут существенно влиять на объем результирующего файла и время поиска информации.

Страница Macros

Определяет макрокоманды, автоматически выполняемые при выборе того или иного ключевого слова.

Keywords - содержит список ключевых слов, для которых определены макрокоманды;

Title that appears... - указывает заголовок окна Найденные разделы при выборе соответствующего слова;

Macro (s) associated with... - связанная со словом макрокоманда;

Add - позволяет добавить слово к списку Keywords;

Remove - удаляет слово из списка Keywords;

Edit - изменяет определение макрокоманды или заголовка для указанного слова.

Страница Build Tags

Содержит список условий, включающих разделы в результирующий файл (верхний список) или исключающих их из него (нижний список). Условия касаются только тех разделов, которые помечены ссылкой “*” (см. п. 21.3.4).

Страница Fonts

Определяет шрифты, используемые в справочной системе.

character set - определяет используемый в результирующем файле набор символов (он может отличаться от набора символов на инструментальной машине);

Font in winHelp Dialog boxes - определяет шрифт, используемый в диалоговых окнах справочной службы;

substitute this fonts.. - содержит перечень подстановок, указывающих, какой шрифт в исходном RTF-файле будет заменен при отображении в окне справки и на какой шрифт он будет заменен.