СОВРЕМЕННАЯ ПОМОЩЬ - HTML-help и с чем ее едят

Kirion (kkr@mailru.com)

Спецвыпуск Xakep, номер #028, стр. 028-094-3

Теперь перейдем собственно к созданию. Определись вначале со структурой, чтобы потом десять раз не переделывать. Определи уровень вложенности и создавай рубрики (aka heading), а потом рассовывай по ним темы, задавай для них файлы и иконки. Если вложенность у тебя отсутствует, можешь обойтись и без рубрик, просто добавляй темы и располагай в нужном порядке. Кстати, не поленись и пропиши во всех html-ках тег <title>. Пригодится и при создании тем и при поиске в готовом файле. Имена разделов по умолчанию совпадают с заголовком паги. Если хочешь извратиться - создай особый тип окна и пропиши его в строке "window" вкладки "advanced". Топик будет выводиться в этом окне вместо стандартного. Проверь, не забыл ли ты какую-нибудь одинокую страничку, на которую не ведет ни одна ссылка или топик в содержании. Все в ажуре? Тогда можешь уже компилировать, но если у тебя файл со сложной структурой или ты хочешь сделать навигацию более приятной - читай дальше.

Индексы и ссылки

Индекс - это вспомогательное средство навигации и поиска. Что-то вроде предметного указателя. Ты сам задаешь ключевые слова и связанные с ними разделы. Кликай на вкладку "index". Как и в случае с содержанием, тебе предложат создать новый файл или указать путь к готовому. В опции можешь не лезть, ничего особенно важного там нет. Разве что шрифт задать и окно для вывода, если не хочешь использовать стандартное. Кликай на кнопку с ключиком и начинай добавлять ключевые слова. При создании индекса ты можешь указывать структуру. Например: ты создаешь ключевые слова "Winfo", "Kirion", выделяешь "Kirion" и жмешь кнопку "move selection right". Теперь по ключевому слову "winfo" будет выводиться список подразделов (который мы создали всего один). Если ключевое слово встречается в разных файлах, ты можешь добавить их через "add..." или "alternate entry". Тогда при выборе слова появится окно со списком доступных разделов. Если же у тебя есть похожие термины или синонимы, ты можешь задать в качестве раздела другое ключевое слово, просто поставь галку "target is another keyword" на закладке "advanced". Есть и другой способ добавления ключевых слов. Он реализуется с помощью Klinks (keyword links). Это объекты ActiveX, представляющие собой ссылку на раздел индекса в тексте раздела. Создаются они так: открываешь код нужного раздела и выделяешь кусок текста. Далее жмешь на кнопку "HTML help ActiveX control" (с изображением цилиндра). В появившемся диалоге выбираешь тип команды "keyword search" и идентификатор нового объекта. Потом задаешь вид окна и самой ссылки и, наконец, список ключевых слов. В готовом файле при нажатии на эту ссылку появится окно с найденными разделами. Но работать все будет только после компиляции. Кстати, можно создать подобные ссылки и без указания ключевых слов. Для этого вместо "keyword search" надо выбрать "Alink search". Все похоже, только вместо ключевых слов ты выбираешь непосредственно разделы. Такая ссылка называется "Alink" (Associative Link). Что-то похожее получится, если в качестве объекта выбрать "Related topics". Если ты заметил, в менюшке выбора типа объекта достаточно много пунктов. Нас с тобой могут заинтересовать еще два: "Splash screen" и "Close window". Как не сложно догадаться, первый из них выводит заставку (указываешь картинку и продолжительность), а второй - закрывает окно (полезно, если ты создал свой тип окна и не хочешь, чтобы на нем были стандартные виндовые кнопки "закрыть", "минимизировать" и т.д.). Остальные объекты ActiveX используются в основном при создании настоящих хелпов к прогам, как "trainig card", например. Этот объект осуществляет связь между прогой и справкой путем посылки виндовых сообщений. Прога может перехватить их и среагировать. То есть по выбору ссылки в хелпе в самой программе будут выполняться определенные действия. Так делаются "Step-by-step" файлы помощи. Объект "Shortcut" используется для посылки сообщений Windows из файла справки. Так можно запускать внешние программы, управлять окнами, вызвать диалоги и еще очень много всего делать - смотри справку по WinAPI :). Объекты "Contents" и "Index" служат для динамического присоединения файлов содержания и индекса соответственно. Самый загадочный объект - "Winhelp". Он служит для вызова раздела Winhelp-справки. На фига? Если у нас есть уже файл HTML-справки...