Квант-Творчества

Создание справочной системы в среде Delphi. Создание справочной системы в среде Delphi не менее сложный проект, как и создание базы данных или нового компонента. Постараемся разобраться в основных вопросах которые сбивают с толку даже опытного программиста который пытается изучить эту среду разработки. И так, что имеем? В Delphi есть только редактор html - страниц. В нём можно вполне успешно наверстать несколько страниц с пояснением к вашему ПО, в зависимости сколько разделов вы планируете, столько нужно страниц. Но вот редактора HTML Help Workshop для создания проекта и файла управления страницами в формате *.chm в Delphi нет! Его надо скачать из архивов Microsoft, возможно такая среда разработки уже установлена на вашем компьютере, поищите: C:\Programs Feles(x86)\ HTML Help Workshop\ hhw.exe Допустим скачали установили. Запускаем программу, открывается окно с главным меню, нажимаем File - New --> поставили галку рядом со словом Project --> в открывшемся окне вам предлагают назвать проект и указать директорию где его нужно сохранить, естественно это общая директория хранения ваших созданных *.html - файлов. Ложем файл проекта в эту же папку. Пока речи о самих файлах справки при создании проекта не идет. Галочку, в окне создания проекта, напротив их ставить не надо. Нажимаем «Готово». У нас получился пустой проект. Теперь нужно подготовить файлы, без которых невозможно создание chm. Что бы файлы проекта имели древовидную структуру, как во всех справочных системах, нужно сначала создать файл таблицы, для этого надо перейти на вкладку «Contents» в окне HTML Help Workshop (Их там всего три вкладки: Project; Contents; Index ). При нажатии на эту вкладку появится вопрос: Мы, конечно же, соглашаемся и создаем новый файл контента. Примем то имя файла, которое предложит нам HTML Help Workshop – «Table of Contents.hhc». С левой стороны обращаем внимание на вертикальный ряд кнопок, ими мы будем пользоваться при создании файла контента. Одна из них «Contents Properties». Пока её не трогаем. Рассмотрим кнопки немного ниже, чем кнопка «Contents Properties», первая (с изображением папки) – создает каталог внутри файла chm, в который можно помещать страницы, вторая (с изображением исписанного листа бумаги) – создает страницу внутри файла chm, третья (карандаш) – редактирует страницу или каталог внутри файла chm, четвертая – удаляет страницу или каталог из списка страниц внутри файла chm. Еще ниже, расположены кнопки, которые позволяют перемещать страницы и каталоги вверх и вниз по списку, также передвигать правее и левее. Предпоследняя кнопка для просмотра HTML кода страницы и последняя, чтоб сохранить всю эту структуру файлов. Итак, давайте приступим к созданию дерева каталогов. Нажмем на кнопку с изображением листика, перед нами появится окно, в котором заполняем поле «Entry title» (у меня набрано О программе). Нажимаем кнопку «Add…», появляется окно «Path or URL», ищем через Browser этого поля - «File or URL» - название нашей первой созданной html страницы. Так как страница хранится в той же папке, что и сам проект – "D:\Файлы справочной системы\n_0.html ", как видите в ручную нет необходимости указывать полный путь к файлу. Жмем кнопку ОК, после того как вы указали еще и альтернативный URL. В окне проекта Contents появится ваш первый файл. URL такой же как и основной, нужно просто продублировать его, опять же не вручную, кнопка поиска есть. И так с каждым html - файлом . Если что-то написали не правильно, есть кнопка редактирования в вертикальном ряду подведите курсор к иконке "карандаш" и ссылка на кнопке укажет редактор. Опять же на втором шаге создания таблицы - "добавить файл" есть рядом Remove, т.е. удалить прикрепленный файл, но не пугайтесь это не физическое удаление, а удаление связи заголовка и файла html. Теперь создадим «Индекс» для файла chm. Для этого перейдем на вкладку «Index» и согласимся создать новый индексный файл «index.hhk». В появившемся окне нажимаем на кнопку с изображением ключа, набираем в поле «Keyword» ключевое слово, у меня привязка слов по заголовкам: "О программе", " First file", "Second file", " Third file", при поиске которого по индексу (когда файл справки будет уже создан) будет открываться определенная страница. После того, как указали ключевое слово, также как и при создании таблицы контента, нужно указать файл, который будет соответствовать этому ключевому слову. Окно создания индекса После того как созданы таблица контента, индекс и сами html файлы можно приступить к непосредственно настройке файла chm. Для этого переходим на вкладку «Project», и тут нажимаем на самую верхнюю в вертикальном ряду кнопку. Настраиваем все как на скриншотах. На вкладке Project есть окно Options --> Files надо указать поля где будет хранится chm - файл: Compiled file: D:\Файлы справочной системы\MyProject.chm Contents file: Table of Contents.hhc Full text sirce stop list file: D:\Файлы справочной системы\searce.stp На вкладке Project есть окно Options --> General --> следует указать названия разделов, у меня "О программе", " First file", "Second file", " Third file", " и т.д.", у каждой вкладки есть поле файла по умолчанию, ну и поля Language: Сохранив проект, можно будет его скомпилировать. Для этого в меню File найдите пункт Compile, откроется окно, где надо будет подтвердить, создание файла *.chm, в какой он будет находится директории и поставить флажки для создания служебных файлов компиляции. Нажать в этом же окне кнопку "Compile". В результате будет доступна информация о процессе компиляции, если все ОК. То можно из окна HTML Help Workshop запустить ваш вновь созданный файл: меню View выбрать команду Compiled Help File --> Browes --> *.chm . На экране должно появиться окно справочной информации. Почему именно так надо запускать файл справки? Если произошли какие-то недочеты можно вновь открыть проект, а не ходить по каталогам в поисках exe- файла запуска программы . Потом проверить все вкладки главного окна программы, исправить ошибки перекомпилировать проект, в этом не чего страшного нет. При двух-трех попытках исправить проект ошибки находятся самим программистом и последующие запуски файла *.chm проходят корректно.