Приемы работы с HelpScribble

HelpScribble является мощным редактором Help-файлов. Он неоднократно признавался лучшим программным средством для создания справочных систем. Рабочее окно программного средства показано
на рис. 5.13. В указанном окне можно выделить следующие элементы: меню команд, таблицу параграфов, окно текста параграфов, панель управления, панель текста, панель параграфов, панель карты настройки, панель ссылок.

Меню команд и панель управления являются общими элементами управления программными средствами. Панель текста служит для настройки параметров текста. Окно текста параграфов является достаточно примитивным текстовым редактором для ввода текста параграфов. Принципы применения и приемы работы с этими элементами описаны в литературе, например, в [5].

 

Рис. 5.13. Рабочее окно системы создания справочных файлов HelpScribble

Создание проекта начинается с создания списка параграфов. Для этой цели служит таблица параграфов, которая содержит список их заголовков и параметров. Добавление параграфов в список производится командой "Topic/New" или кнопкой "+" на панели карты настройки. Наиболее полно настройку параграфов можно выполнить с помощью карты настройки
(рис. 5.14).

Рис. 5.14. Карта настройки параграфов Основными параметрами параграфа являются: · ID – номер параграфа (задается автоматически), · Title – заголовок, · Keywords – ключевые слова для системы поиска, · Status – напоминание о стадии создания параграфа, · Window type – имя окна, в котором открывается параграф. Любое свойство параграфа можно редактировать в любой момент создания проекта справочной системы.

Следующим шагом является создание описания окон справочной системы. Для этой цели служит "Редактор окон" (рис. 5.15). Он позволяет описать

Рис. 5.15. Редактор окон первичные и вторичные окна справочной системы. Первичное окно имеет имя "main", остальные – любые имена. Параметрами окон являются: · Window name – имя окна в системе, · X,Y – координаты верхнего левого угла, · Width – ширина окна, · Height – высота окна, · цвета окна для прокручиваемой и непрокручиваемой областей (рис. 5.3,а,б).

Добавление окна выполняется кнопкой "+", находящейся под списком окон. Размеры окна и его местоположение на экране можно настроить визуально, нажав кнопку Position Wizard. Нажав кнопки Window Color и Non-scrolling region, можно настроить цвета областей окна. Имя окна и его заголовок (Caption) вводятся с клавиатуры. Задав параметры окна, необходимо перенести их в список окон. Для этого нужно щелкнуть мышкой по имени окна. Только после этого параметры окна будут записаны.

Третьим шагом является создание оглавления справочной системы.Для этого служит окно "Редактора оглавления"(рис. 5.16), имеющее вкладки General и Contents. На первой вкладке достаточно задать имя справочной системы Title. На второй вкладке Contents можно задать все параметры оглавления. В верхнем поле окна размещается список заголовков глав и параграфов. В правом поле, вызываемом кнопкой ">>" при исходном состоянии окна (кнопка "<<" на рис. 5.16) размещается список параграфов. В средней части вкладки размещается панель управления, а в нижней – свойства элементов оглавления.

В исходном состоянии в окне показан пустой список. Включив кнопку Header, можно ввести заголовок главы и нажатием клавиши Enter или кнопки "+" добавить главу в список. Далее, включив кнопку Link to this help file и вызвав список параграфов в правую область вкладки кнопкой ">>", можно в выбранную главу добавить нужные параграфы, заголовок параграфа можно задать в окне Title, нужный параграф необходимо указать в окне Topic.

Четвертым шагом является создание текстов параграфов и ссылок. Для этого обычным способом вводится содержательный текст параграфа. После заголовка параграфа можно вставить команду {keepn}, которая укажет на включение заголовка в непрокручиваемую область окна. В текст параграфа можно вставить точечный рисунок. Для создания рисунков в HelpScribble имеется свой графический редактор SHG Editor.

Рис. 5.16. Окно редактора оглавления

В тексте параграфа обычно создаются ссылки на другие параграфы. Для создания ссылки необходимо выделить нужный фрагмент текста параграфа и командой "HelpTools/Link…" вызвать окно "Insert Link" (рис. 5.17). Внешний вид ссылки регулируется переключателем Linked Text, местоположение

Рис. 5.17. Окно "Insert Link" ссылки – переключателем Link. В окне Topic указывается параграф, вызываемый ссылкой, а в окне Window – имя окна для этого параграфа. Установка флажка Popup link указывает на помещение параграфа в PopUp-окно. На любой стадии создания проекта справочной системы можно записать проект на диск, просмотреть работу Help-файла и скомпилировать готовый проект с записью на диск. Для этого в окне "Project options" необходимо указать компилятор Help-файла и имя проекта, которое будет

выводиться в заголовок первичного окна справочной системы. Далее можно посмотреть работу готовой системы командой "Project/Show Help file" или скомпилировать готовый проект на диск командой "Project/Make".