HelpMaker: создаем справочную систему

(Продолжение. Начало в №22)


Управление объектами

Управление объектами удобно осуществлять при помощи панели инструментов в области "Document Маp":

Панель содержит следующие инструменты:

  1. Добавить объект.
  2. Редактировать заголовок.
  3. Удалить объект.
  4. Кнопка "Переместить влево", то есть изменить тип объекта на "Раздел".
  5. Кнопка перемещения объекта в общем списке вверх.
  6. Кнопка перемещения объекта в общем списке вниз.
  7. Кнопка "Переместить вправо", то есть изменить тип объекта на "Глава".


Создание гиперссылок

Гиперссылки являются одним из важнейших элементов справочной системы. Именно гиперссылки обеспечивают справочную систему удобным механизмом навигации по функционально связанным страницам.

Создание гиперссылки осуществляется так.

  1. На вкладке "Управление справкой" выделить текст, который будет гиперссылкой.
  2. Выполнить команду Вставка > Гиперссылка или щелкнуть кнопку ("Добавить гиперссылку") на панели инструментов окна "Управление справкой". Появится окно "Гиперссылка".
  3. Установить курсор на названии нужного объекта.
  4. Выбрать тип ссылки.
    • Normal Link. Обычная ссылка.
    • Link to Popup Window - привязка к всплывающему окну.
  5. Щелкнуть "ОК".

При создании ссылок возникают проблемы, связанные с использованием кириллицы. Из собственного опыта рекомендую следующее.

  1. Вводите информацию в поле "ID главы" на английском языке.
  2. Во время непосредственного создания ссылки переключайтесь на английскую раскладку.

Несмотря на то, что на форуме программы утверждается, что проблема отображения гиперссылок некорректным шрифтом исправлена в сборке 315+, проблема, во всяком случае, для кириллицы, остается, и иногда приходится несколько раз создавать ссылку, добиваясь ее корректного отображения.


Настройка компиляции

Перед первой компиляцией необходимо выполнить ее настройку, для чего щелкните на имени проекта (для нашего примера это "Справка по Visual Fox") в области "Document Маp", после чего откроется окно, состоящее из нескольких вкладок.


Вкладка "Проект"

Ввести имя основного файла (проекта), например, "HelpFox". Это имя используется как в качестве папки, где будут храниться проекты, так и в качестве имен создаваемых на диске файлов. Отмечу, что имя не должно содержать пробелов, да и сама программа не допустит их использования в имени. Но если все-таки изобретательный пользователь и умудрится использовать в имени пробелы, например, вставив имя с пробелами из буфера обмена, то программа автоматически удалит пробелы из имени, объединив все разделенные пробелами слова в одно имя.

Установить флажки возле форматов файла, в которых будет создаваться файл справки. Их три: WinHelp, HtmHelp и Web-сайт. Отсутствие флажка хотя бы для одного из форматов повлечет за собой при компиляции появление в окне компиляции сообщения об ошибке: "Project is Blank: Please select a target to compile" ("Выберите формат справки компиляции").

Установить флажки для действий "Скомпилировать проект", "Показать файл справки после компиляции". По моему мнению, целесообразно также после компиляции удалять временные файлы.


Вкладка "Общие"

Ввести общий заголовок справки, например, "Справка по Visual Fox". Именно этот текст будет отображаться в заголовке окна справки. В списке "Глава по умолчанию" выберите имя из поля "Текст дерева проекта", например, "оглавление". При необходимости в поле "Авторские права" введите нужную информацию.


Вкладка "Контекстная справка"

Включите действие "Автоматически присваивать новые контекстные номера справки создаваемым главам", выберите начальный номер справки, приращение (шаг, с которым автоматически будет изменяться номер), и при необходимости измените значение текущего номера.

Нумерация объектов нужна, в первую очередь программистам, когда справку необходимо подключить в программе. При таком варианте номера используются в свойствах объектов программы, позволяя обращаться к нужной части справки по номеру. В этом случае советую установить значение реквизита "Приращение" больше "1", например "10", поскольку достаточно часто возникает необходимость вставить новый объект в средине уже имеющейся информации.

Всем остальным пользователям можно попросту установить значение для начального номера справки и приращения "1".


Другие вкладки

Вкладки WinHelp, HtmHelp, Web-сайт позволяют задать некоторые дополнительные действия для трех различных форматов, в которых может создаваться система. Если справка создается на русском языке, то на вкладке "UNICODE" обязательно установите переключатель в положение "Russian / Russia". Данная настройка имеет высокую степень важности, поэтому обязательно убедитесь в том, что переключатель действительно установлен.

Некоторые настройки позволят навести на справочный файл "глянец". Так, для русскоязычного варианта справки неуместно будет наличие в ней ссылок Next, Previous, Top, обеспечивающих соответственно переходы к следующему или предыдущему просмотренному окну либо к оглавлению. Представляется естественным подставить вместо них, например, красивые кнопки. Для этого на вкладке "Настройки HTML" для полей "HTML тег - Вверх: (Далее, Назад)" щелкните кнопку "Image" ("Изображение") и определите путь к необходимым графическим файлам.


Настройка окна вывода справочной системы

В нижней части области "Document Маp" находятся пункт "Windows List", содержащий пункты "Main" и "Popup", где можно задать параметры окна с выходной информацией соответственно для главного окна ("Main") и всплывающих подсказок ("Popup").

Так, размеры окна и цвет его фона определяются на вкладке "Размер и цвет". Разработчики рекомендуют устанавливать максимальный размер 640 x 480 для мониторов любого размера, а для мониторов большого размера 800 x 600. Но все это дело вкуса. Мне, например, нравится размер окна 1000 х 700 со значениями отступов для "Х" и "У" (отступы от левого угла монитора) "10". Вообще можно просто щелкнуть кнопку "Full Size" и установить тем самым максимальный размер окна вывода.


Компиляция

Для представления информации в виде файла-справки необходимо выполнить компиляцию. Это можно сделать несколькими способами: выполнить команду Инструменты > Компилировать, щелкнуть кнопку на панели инструментов или нажать функциональную клавишу <F9>.

После этого появится окно компиляции, отображающее процесс компиляции. Ход компиляции отображается на английском языке:

Собственно, вся информация заключена между начальным сообщением "Start Compiling..." ("Старт компиляции") и завершающим сообщением "Stop Compiling..." ("Конец компиляции"). Желающие могут "покопаться" в списке сообщений, выводимых компилятором (а здесь содержится перечень подключаемых рисунков, создаваемых HTML-файлов и пр.), однако можно обойтись и без этого. Отмечу два неудобства, исправление которых только повысило бы рейтинг программы. Во-первых, при открытом файле справки процесс компиляции не начинается. И хотя система честно предупреждает о необходимости закрыть файл справки "CHM File Locked: Please close the CHM file first", было бы гораздо лучше предусмотреть возможность автоматического закрытия файла справки при обнаружении того факта, что он открыт. И второе. Непонятно, зачем каждый раз закрывать окно компиляции по ее завершении. Намного удобнее (и логичнее) предусмотреть в этом окне кнопку с повтором процесса компиляции, при котором одновременно очищается предыдущая сессия компиляции.

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

До того, как мне попалась данная программа, я работал с Microsoft Help Workshop. Преимущества программы HelpMarker были настолько очевидны, что я сразу же перешел на работу именно с ней. При этом я решил воспользоваться возможностью импорта имеющейся из проекта Microsoft Help Workshop. Как отмечалось выше, при создании проекта был использован вариант "Create a new HelpMaker Project". Но в этом же окне из списка можно выбрать еще один вариант: "Import an existing WinHelp File" ("Импортировать из существующего справочного файла"). Этот вариант и был мною использован. К сожалению, не могу признать экспорт удачным, хотя разработчиками уверяется, что практически все документы Word могут быть скопированы в HelpMaker без потери оформления. Действительно, частично перебросить информацию из одной системы в другую мне удалось, при этом сохранилось и довольное большое количество ключевых слов. Оставшуюся же информацию мне пришлось переносить вручную, впрочем, много времени у меня это у меня не отняло. Но в любом случае, "овчинка выделки стоит", то есть переход с Microsoft Help Workshop на работу HelpMarker влечет за собой значительные преимущества:

  1. Бесплатность.
  2. Наличие единой интегральной системы, объединяющей редактирование текстового наполнения справки с управлением объектами. Напомню, что Help Workshop является компилятором, а работа с текстом осуществляется в Word с документом в формате RTF, то есть расширенным текстовым форматом (Rich Text Format). Используемый в нем механизм создания ссылок достаточно неудобный и громоздкий, в отличие от простого и интуитивно понятного механизма в HelpMaker.
  3. Дружественный и интуитивно понятный интерфейс.
  4. Простота освоения.
  5. Возможность создания таблиц, рамки которых будут в справке отображаться (в Help Workshop - нет). Вообще, работа с таблицами представлена на высоком уровне. Пользователь имеет возможность выполнять с таблицами практически все действия, предлагаемые мощными текстовыми редакторами. Откройте пункт главного меню "Таблицы", и вы легко убедитесь в этом.

Валерий ФЕТИСОВ

Версия для печатиВерсия для печати

Рубрики: 

  • 1
  • 2
  • 3
  • 4
  • 5
Всего голосов: 0
Заметили ошибку? Выделите ее мышкой и нажмите Ctrl+Enter!

Комментарии

Страницы

подскажите пожалуйста-после компиляции не отображаются картинки.просто квадратик и крестик в нем.что делать???

Аватар пользователя mike

А, есть такая заморочка. Это потому, что картинки берёшь не из родного для хелпмейкера директория. Ну, уж раз пошла такая пьянка, то попробуй так: щёлкни по вставленному рисунку (до компиляции), затем:  редактирование-редактировать рисунок-окно пикче-вкладка линк и ...повторно вставить рисунок. Потом компили. Должно прокатить.  

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

Аватар пользователя mike

Ну выделяешь текст, затем в главном меню щёлкаешь гиперссылку, тебе выводится список привязок, щёлкаешь привязку и сохраняешь. Если будут кракозябры, то влазишь редактором в синюю ссылку и перебиваешь по-русски,  обрамляющие кракозябры клавишей дилит удаляешь. Затем сохраняешь и компилишь. Через анал, конечно, но у меня прокатывает.

с рисунками не прокатило.ссылки тоже не получаются-переключаюсь на английский язык,выделяю текст, гиперссылка,выбираю привязку,ок.все читается.нажимаю перейти-переходит.а после компиляции-открываю где ссылка, а она крякозябра и не активна!!!что делать ума не приложу.версия программы 7.4.4.0

о.с ссылкой что то получилось-теперь нет кракозябр, за то когда переходиш по ссылке вылазит интернет эксплорер и пишет что не удалось загрузить.что за хрень???

Вроде получилось.с компилировал.сейчас посмотрим как на другом компьютере откроется!!!

Аватар пользователя Al

А куда ж оно денется... Откроется...

 

Подскажите пожалуйста-можно ли как ни будь сделать гиперссылку на отдельный кусок текста??? например:в одной главе термин, а в другой, в середине определение.как сделать ссылку на середину главы???на это определение???просто если определение в конце лекции, а ссылка идет только на всю лекцию-начало, то искать это определение до конца главы-нет смысла,особенно когда лекция ооооочень большая

Аватар пользователя mike

Кажется, тут есть ответ.

Страницы