Существует несколько вариантов создания справочной системы. Можно сделать файл справки в формате .DOC или .RTF (MS Word), но для его правильного отображения на компьютере клиента должен быть установлен MS Office, желательно той же версии, что и тот, в котором создавался файл справки. Можно создать набор HTML файлов и подключать их к программе в нужных местах. Но это, во-первых, требует написания дополнительного кода (создание класса, инкапсулирующего подгрузку файлов, их адресацию и линковку к нужным местам программы, и во-вторых, наличие на компьютере клиента программы просмотра HTML документов (браузера) той же версии, что и тот, в котором производилась отладка и тестирование созданной справочной системы.
Наиболее популярными на данный момент форматами справочной системы являются WinHelp (.HLP) и Compiled Help (.CHM). Средства просмотра для них встроены в Windows, к тому же это “родные форматы” справки Windows, разработанные самой Microsoft.
Из этих двух форматов более удобным является Compiled Help, т.к. имеет более развитый интерфейс и большие возможности по сравнению с WinHelp. Файл справки Compiled Help представляет собой скомпилированные в единый файл множество документов HTML с подключаемыми к ним файлами JavaScript, CSS и файлами изображений (.JPG, .GIF, .PNG, .BMP), соответственно для этого формата доступны все преимущества клиентских сценариев JavaScript и каскадных стилей CSS. Файл справки WinHelp является скомпилированным во внутренне представление набором файлов RTF (Rich Text Format) с расширенными возможностями разметки, предназначенными для возможности программной адресации структур справки.
Помимо указанных преимуществ формата Compiled Help следует отметить так же простоту его создания по сравнению с WinHelp, т.к. для этого нужно знать только язык гипертекстовой разметки, который намного проще и понятней человеку, чем разметка RTF.
Для иллюстрации процесса создания файла справки в формате Compiled Help создадим такую справку для нашей программы учета гостиничных номеров.
Для компиляции файла .CHM необходимо иметь два файла – HHC.EXE и HHA.DLL, которые нужно поместить в каталог <WinDir>\System32, если на компьютере используется операционная система WinNT/2k/XP, или <WinDir>\System, в случае использования Win9x/ME. Бесплатно загрузить эти файлы можно с Web-сайта http://www.microsoft.com или http://www.bousoft.com. Для создания всех остальных файлов (файлы проекта, содержания, информационные файлы) вполне достаточно входящей в состав Windows программы “Блокнот” (“Notepad”).
Для создания справки в формате Compiled Help требуется как минимум 2 файла:
· файлы проекта справки (.HHP);
· файл содержания (.HHC).
Если требуется создать индекс, то также необходим файл .HHK. Помимо этого должны быть созданы файлы, в которых содержится сама справочная информация. Это обычные HTML документы, для которых устанавливается только одно требование – наличие META-информации об используемом языке и кодовой странице (в Windows это обычно ”cp1251”). Еще одно специфичное свойство HTML разметки файлов справки .CHM – это формат адресации в ссылках (тэги <A>). Для того, чтобы сослаться на другую страницу внутри файла справки ссылка должна иметь следующий формат:
<A href=“mk:@MSITStore:<имя файла справки (.CHM)>:: <имя файла HTML (.HTM)>”>
Документы HTML необходимо предварительно подготовить и собрать в одном каталоге.
Файл проекта справки (.ННР) представляет из себя обычный INI файл разделенный на секции, в которых содержатся пары [параметр] = [значение].
Всего в этом файле должно быть не менее трех секций. Рассмотрим их назначение.
· Секция [OPTIONS] описывает общие настройки создаваемого файла справки, в ней содержатся следующие параметры:
- Compatibility – определяет совместимость полученного файла справки с программой просмотра (HH.EXE). Для полной совместимости нужно указывать версию 1.1.
- Compiled file – имя итогового файла формата Compiled Help (.CHM).
Уважаемый посетитель!
Чтобы распечатать файл, скачайте его (в формате Word).
Ссылка на скачивание - внизу страницы.