8.4. Разработка справочных систем в формате html

Разработку таких систем целесообразно вести в программе HTML Help Workshop.

Программа входит в состав Visual Studio 6.0. Главное окно программы показано на рисунке 8.7.

Рис.8.7. Окно программы.

Исходный текст справочной службы представляет собой проект и состоит из следующих файлов:

*.HHP – главный файл проекта

*.HHC – файл содержания

*.HHK – файл поисковых ключей

*.H – заголовочный привязки псевдонимов тем к числовым индексам.

*.HTML – файлы с текстами тем справочных файлов.

В результате компилирования справки на диске создается файл *.CHM пригодный для просмотра справочной службой Windows.

8.4.1. Создание тем справочной службы

Процесс создания справочной системы начинается с написания текста тем. Темы оформляются в виде отдельных HTML файлов. Создать справочные файлы не выходя из программы можно командой: File > New > HTML File. Либо с помощью инструмента . При наборе текста используют следующие инструменты

Инструмент	Назначение
	Тег жирного шрифта.
	Тег задания курсива.
	Тег задания по­дчеркивания.
	Просмотр в браузере.
	Запись результата.

8.4.2. Создание проекта справочной службы

После завершения написания тем следует сформировать проект справочной системы:

File > New > Project. Проект создается мастером из нескольких шагов. При работе с мастером нужно указать имя файла проекта и названия и расположение HTML файлов с текстом справки. Имя нового файла справки вводится после нажатия кнопки Browse. После формирования проекта открывается окно разработки системы.

Рис.8.8. Левая часть окна создания проекта

Таблица 8.1. Вкладка Project

Инструмент	Назначение
	Сhange project options. Настройка параметров проекта
	Add/Remove topic files. Добавление HTML файлов тем
	Add/Modify Window definition. Задание всплывающего окна
	HtmlHelp API information. API параметры.
	View HTML source. Загрузка содержимого темы справки
	Save project, contents and index files. Запись файлов проекта
	Save all project files, and compile. Запись всех файлов и компилирование.

На вкладке Project выполняют следующие действия с помощью инструмента «Сhange project options»:

Задают название проекта (Title), определяют язык справочного файла(Language of help file), HTML файл темы с которой начинается просмотр справки (Default file).

Затем нужно задать псевдонимы справочных файлов HtmlHelp API information > вкладка Alias

Например:

idTopic1=topic1.html

idTopic2=topic2.html

idTopic3=topic3.html

Каждой теме нужно поставить в соответствие числовой код. Для этого следует создать текстовый файл с расширением *.h и директивами #Define idTopic n (File > New > Text).

После сохранение файла его нужно добавить в проект:

Таблица 8.2. Инструменты редактирования

Инструмент	Назначение
	Contents properties(Параметры оглавления).
	Insert a heading (Вставка темы).
	Insert a page (Вставка страницы).
	Edit selection (Редактировать выделенный объект).
	Delete selection (Удалить объект).
	Управление иерархий.
	View HTML source(Просмотр HTML файла).
	Save file (Записать файл).

HtmlHelp API information > вкладка Map.