Ассоциативные ключевые слова поддерживаются только в формате HTML Help (CHM). Они позволяют автоматически создать список всех разделов справки с заданным ассоциативным ключевым словом (или несколькими ключевыми словами). В обычных проектах справки ассоциативные ключевые слова используются для создания списков ссылок на разделы по смежным темам «Смотрите также».
В модульных системах справки они также используются для создания ссылок на разделы из других файлов справки, на которые ссылается оглавление. Так как список ссылок генерируется автоматически во время использования справки, в нем нет битых ссылок – ссылок на разделы из файлов справки, не вошедших в поставку. Подробное описание смотрите в статье Что такое ассоциативные ключевые слова.
Как создать список ссылок на разделы со смежными темами
Перед началом использования данной технологии необходимо продумать осмысленный список уникальных ассоциативных ключевых слов, которые не должны совпадать с обычными ключевыми словами. При работе нескольких авторов над обычным или модульным проектом справки данный список должен быть общим. Далее необходимо выполнить 2 этапа работ:
- Прописать ассоциативные ключевые слова в необходимые разделы справки.
- Создать ассоциативные ссылки, которые будут генерировать список ссылок на разделы по смежным темам.
Прописать ассоциативные ключевые слова
- Откройте проект Help+Manual.
- В Project Explorer выделите раздел, в который необходимо добавить ассоциативное ключевое слово.
- В редакторе текста перейдите на вкладку Topic Options.
- В поле A-Keywords for HTML Help введите одно или несколько ассоциативных ключевых слов. Обратите внимание на то, что дочерние ключевые слова не поддерживаются.
- Добавьте данное ассоциативное ключевое слово в разделы, которые необходимо «ассоциировать» с данным разделом.
- Повторите процедуру для остальных ассоциативных ключевых слов.
Создать ассоциативные ссылки
- В тексте раздела выберите место, в которое необходимо вставить ассоциативную ссылку.
- На вкладке Write щелкните Link или нажмите сочетание клавиш Ctrl+L.
- В открывшемся диалоговом окне Insert Hyperlink перейдите на вкладку Script Link.
- Установите переключатель Type of script / macro: в положение WinHelp Macro.
- В поле Script: введите Alink() и в скобках через точку с запятой введите ассоциативные ключевые слова, по которым будет генерироваться список ссылок на смежные темы. Обратите внимание на то, что другие параметры макроса WinHelp Alink не поддерживаются.
- При необходимости задайте остальные параметры ссылки: текстовую метку (Caption), всплывающую подсказку (Tooltip) и стиль отображения — ссылка (Link), текст (Text), кнопка (Button) или рисунок (Picture).
- В окне Insert Hyperlink нажмите кнопку ОК.
- Добавьте ассоциативные ссылки в остальные разделы аналогичным образом.
- Сохраните внесенные изменения.
После сборки CHM-файла ссылка из приведенного выше примера будет выводить на экран в отдельном окне список ссылок на все разделы справки, содержащие ассоциативные ключевые слова «сортировка» или «фильтрация».
