Сделать справку к программе

Справочная система (далее в тексте также — «справка») — важная составная часть любой более-менее сложной (и даже простой) программы. Существуют разные форматы справочных систем. Справка в формате WinHelp — о ней в статье и пойдет речь, Html-help — как, например, справка к ОС Windows или к программам MS Office.

В качестве справки может выступать набор связанных html-файлов, например так организована справка к СУБД MySQL. Из достоинств WinHelp можно назвать ее надежность и меньшие, чем у HTML-help, требования к ресурсам. Существуют различные программы для создания справочных систем названных типов.

Однако, для создания несложной справки вполне достаточно стандартной программы MS Help Workshop, которая поставляется с Delphi. Потребуется еще редактор rtf файлов, в данной статье описывается работа со знакомым всем MS Word’ом.

Все действия, которые будут описаны — несложные, но мне в свое время потребовалось определенное количество усилий и времени, чтобы разобраться по справке к Help Workshop, как все это делать. Надеюсь, что статья сможет облегчить этот путь для других. Расчитана она на начинающих. В статье описывается создание простой справки, оглавления к ней, создание последовательностей просмотра, вставка рисунков и гиперссылок, а также подключение справки к программе. Рассматривается только техническая сторона, вопрос о том, что написано в справке, оставлен в стороне.

Как заполнить сведения о доходах в программе «Справки БК»

В состав операционной системы Windows входит подсистема поддержки справки — WinHelp. Она имеет свое API, которое позволяет предоставить справочную информацию в том или ином виде в приложениях Windows. Создание справочной системы можно разделить на две части

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

В состав справки к программе обычно входит несколько файлов:

• Файлы содержащие собственно информацию — имеют расширение .hlp
• Файлы оглавления — .cnt (от апглийского content)
• После первого вызова справки WinHelp создает файл .gid
• Также другие типы файлов, например, для полнотекстового поиска, о чем в статье речь не идет.

Создание тематических файлов.

Для создания справки сначала нужно подготовить файлы, содержащие справочную информацию. Это — обычные документы в формате rtf, которые можно создавать с помощью различных программ. Я здесь буду описывать работу с MS Word (создаем документ и выбираем «Сохранить как» — «Текст в формате RTF»). Будем называть эти файлы тематическими (topic files).

Для получения из тематических файлов готовых файлов справки (hlp), их нужно обработать (компилировать) программой HelpWorkshop (hwc.exe). Кроме собственно текста и рисунков, тематические файлы могут содержать также специальную разметку, которая несет в себе информацию, нужную для создания переходов по ссылкам, связи оглавления справки с ее темами и т.п. — для реализации различных возможностей WinHelp.

Создание файла справки в формате CHM для Windows-приложения — Урок 9 — Изучаем Dr.Explain

Обычно справка содержит несколько тем и оглавление, из которого можно перейти к этим темам. Самый простой вариант: если тема — одна и оглавления нет. В таком случае просто пишем то, что нужно и сохраняем это в файле с расширением «.rtf». Для создания нескольких тем процесс усложняется ненамного:

• Каждая тема должна заканчиваться жестким переходом на новую станицу. Для этого после окончания темы нужно в меню (напомню, что речь идет о MS Word) «Вставка» выбрать «Разрыв»->»Начать новую страницу».

Для того, чтобы тема были доступна из оглавления к справке, нужно задать ей идентификатор. Для этого нужно в то место текста, куда будет впоследствии происходить переход из оглавления (начало темы или, если нужно, другое место), вставить специальную разметку, а именно: концевую сноску. Символом сноски нужно выбрать «#». Идентификатором темы служит текст сноски.

Например, создадим тему «Поддержка», отделим ее от других тем разрывами страниц и зададим ей идентификатор «support». Для этого поместим каретку ввода около заголовка темы и выберем в меню «Вставка»->»Сноска. «. В диалоговом окне (рис.1) выбираем вид сноски — «концевая», нумерация — «другая», в окошке для ввода символа пишем «#» (без кавычек, понятное дело). Нажимаем ОК, ссылка добавлена и каретка автоматически переведена к тексту ссылки. Пишем «support». Готово.
Повторяем то же самое для всех тем справки. Сохраняем файл. Теперь можно попробовать создать свой хелп.

Рис.1. Добавление концевой сноски.

Запускаем программу HelpWorkshop. Это — файл Hcw.exe в директории DelphiHelpTools. Создаем новый проект через меню «File»->»New»->»Help Project». Справа на панели есть ряд кнопок, нажимаем «Files. «. В диалоговом окне добавляем наш тематический файл и закрываем это окно. Сохраним проект — это будет файл с расширением hpj (Help Project).

Насколько я понял, после первого запуска Help Workshop связывает себя с файлами hpj, а также — с файлами оглавления справки (cnt), так что их потом можно открывать двойным щелчком мышью. Для создания help-файла можно просто нажать кнопку «Save and Compile». Откроется новое окно с сообщением о результате компиляции. Предположим, что все в порядке, закроем это окно.

Теперь в директории, где находился наш проект (.hpj), должен появиться файл справки. Однако, при двойном щелчке мышью на нем мы сможем просмотреть только первую тему. Чтобы просматривать все темы и перемещаться между ними, нужно добавить файл оглавления.

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

Файл оглавления справки имеет простой текстовый формат, но создавать его удобно тоже в HelpWorkshop. Для этого выбираем в меню HelpWorkshop «File» -> «New» -> . В верхней части окна нужно вписать имя главного файла справки (файлов, вообще говоря, может быть несколько) и заголовок (title) для оглавления справки. То же можно сделать в диалоговом окне, которое открывается при нажатии кнопки Edit. .

Теперь создаем собственно оглавление. Оно состоит из элементов двух типов — разделы справки, которые включают в себя несколько тем и представлены в оглавлении справки значком книжки и сами темы — текст и картинки, представлены в оглавлении справки значком листа со знаком вопроса на нем (можно посмотреть это в оглавлении любой справки).

Также в оглавление можно вставить макросы и включить файлы (include), этого я здесь касаться не буду. Справа на панели есть набор кнопок для добавления и манипуляции элементами оглавления. (Add Below — Добавить ниже, Add Above — Добавить выше, Move Right — Сдвинуть вправо, Move Left — Сдвинуть влево, Edit, Delete). При помощи них создаем нужную структуру оглавления.

При добавлении раздела в диалоговом окне нужно указать только его название, при добавлении темы — название, идентификатор (тот, который мы задали ей в rtf-файле, когда вставляли концевую сноску), имя help-файла и имя окна. Если тема находится в том же help-файле, который мы указали как главный, то имя help-файла указывать не нужно.

Имя окна указывать тоже не обязательно, если оно не указано, то тема откроется в окне по-умолчанию. Нужно сохранить файл оглавления (он будет иметь расширение .cnt) в той же директории, где находится help-файл лучше с тем же именем, что и help-файл. Теперь нужно снова открыть файл проекта .hpj и, нажав кнопку «Options», в открывшемся диалоговом окне на закладке «Files» указать наш файл оглавления (Contents file). Закрываем диалоговое окно, снова нажимаем «Save and Compile». Теперь при двойном щелчке мышью по значку файла справки должно открыться ее оглавление, из которого можно получить доступ ко всем темам.

Мне не удалось, похоже, это невозможно, создать такую структуру оглавления, чтобы в самом левом ряду сначала шел значок темы (например, «Общие сведения»), а под ним — значки разделов. Пришлось даже для одиночной темы создавать раздел, содержащий ее одну.

Создание последовательностей просмотра.

1. Создать одну или несколько последовательностей просмотра (browse sequence) в .rtf файле текста справки, добавив соответствующую разметку.
2. Определить в проекте справки (файл .hpj) окно с соответствующими кнопками.

Разметка имеет следующий вид: это тоже концевые сноски, как и для идентификаторов тем, однако в данном случае знаком сноски служит не символ «#», а «+» — знак плюса. Текстом сносок может быть либо число, либо строка символов. Просмотр будет осуществляться в порядке возрастания (как при сортировке строк). Отсюда следующее — если используются номера, то нужно вставлять необходимое количество нулей перед значащими цифрами для правильной сортировки. Например, если у Вас 20 тем, то первые нужно нумеровать как 01, 02, и т.д. Возможно несколько вариантов:

• Если последовательностей несколько, то каждая из них может иметь имя, а темы внутри последовательности отличаться номерами (например, GUI1, GUI2, GUI3, . ), Если номера не заданы, WinHelp сам создаст последовательность просмотра при компиляции проекта в том порядке, как расположены темы в файле .rtf.
• Если не писать ничего в текстах ссылок или написать во всех ссылках «auto» (без кавычек), то WinHelp при компиляции создаст одну последовательность просмотра в том порядке, как расположены темы в файле .rtf.

Чтобы добавить кнопки навигации «>» в окне справки (по умолчанию их нет), нужно определить хотя бы одно окно. Для этого, открыв файл проекта в HelpWorkshop, нужно нажать кнопку «Windows. » в правой части окна. В диалоговом окне с закладками нажать кнопку «Add. » и в открывшемся окне ввести в поле названия «main», а поле типа окна очистить, после чего нажать OK.

Теперь у нас определено одно окно, различные свойства которого можно изменять, перемещаясь по закладкам. На закладке «Buttons» отмечаем галочкой «Browse». Нажимаем ОК, готово. Теперь окно справки будет иметь нужные кнопки. Нажимаем «Save and Compile» внизу окна и можем проверять, что получилось в выходном help файле.

Добавление картинок и гиперссылок.

Бывает, что в справку нужно поместить изображения. Это можно сделать, просто добавив их в документ rtf обычным для MS Word способом. Если одно изображение используется в нескольких местах, то можно воспользоваться специальной разметкой, предусмотренной для вставки изображений в справку, так что изображение будет храниться в одном экземпляре. Здесь я не буду рассматривать, как это сделать (честно говоря, я этого никогда и не делал).

ExecFile(program[, arguments[, display-state[, topic-ID]]])
Наш сайт: www.mysite.ru!ExecFile(http://www.mysite.ru)

Примечание : URL в скобках должен быть без кавычек.
Далее, нужно отформатировать этот отрывок так: текст hotspot’a должен иметь двойное подчеркивание, а символ «!» и текст макроса после него — иметь атрибут «скрытый». И то, и другое делается через меню «Формат» -> «Шрифт» (см. рис. 2) На всякий случай, еще раз уточню: двойное подчеркивание (выпадающий список рядом с «цветом текста»), а не зачеркивание..

Теперь, если добавить такой hotspot и компилировать проект, то мы увидим в своей справке, что в строке текста

Наш сайт: www.mysite.ru — адрес выглядит и функционирует как гиперссылка.

Присоединяем справку к программе.

Чтобы справка была доступна в программе, нужно указать программе на файл .hlp. Самый простой способ размещения файла справки — в той же папке, где находится исполняемый файл. Определить для приложения файл справки можно так: открыв проект (приложения) в Delphi и выбрав меню «Project» -> «Options» -> «Application», вписать название файла справки в поле ввода «Help file». При этом нужно указать название файла без пути. Когда WinHelp пытается найти справочный файл, одна из просматриваемых директорий — та, где расположен исполняемый файл программы. Другой способ — в обработчик события OnCreate главной формы программы вставить строку:

Application.HelpFile:=ExtractFilePath(Application.ExeName) + «MyHelp.hlp»;

где MyHelp.hlp — название файла справки.

Чтобы из меню в программе вызвать оглавление справки, нужно воспользоваться функцией

Application.HelpCommand(HELP_FINDER, 0);

Чтобы перейти к одной из определенных нами тем справки, нужно вызвать функцию

Application.HelpJump(‘MyTopic’),

где MyTopic — идентификатор темы.

Один из способов вызова справки — нажатие клавиши F1. Можно организовать вызов контекстной справки при нажатии на F1, когда активным является тот или иной элемент управления. Для этого соответствующей теме справки нужно присвоить номер, а затем этот номер присвоить свойству HelpContext элемента управления.

Чтобы задать номера для тем справки, нужно открыть проект справки в HelpWorkshop и нажать кнопку «Map» в правой части окна. Нажимаем в диалоговом окне «Add», вводим идентификатор темы и произвольный номер (например, 1 🙂 ), повторяем это для всех нужных тем (каждой — свой номер), закрываем окно и нажимаем в очередной раз «Save and Compile». Затем в Delphi, в окне инспектора объектов, присваиваем нужные номера нужным элементам управления (напоминаю, свойство HelpContext).

Ссылки по теме

• Подробнее о продуктах Embarcadero / CodeGear
• Обратиться в «Интерфейс» за дополнительной информацией/по вопросу приобретения продуктов
• Курсы обучения по продуктам компании Embarcadero/CodeGear

02.2009

Источник: www.interface.ru Сделать справку к программе Ускоряет систему, реестр и доступ в Интернет. Оптимизирует, чистит и исправляет все проблемы с ПК в 1 клик. Выявляет и удаляет шпионские и рекламные модули. Программа — победитель многих конкурсов. Подробнее HelpNDoc — мощная и удобная в использовании программа, с помощью которой можно быстро и легко создавать справочную документацию в разнообразных форматах, включая CHM, HTML, PDF или совместимых с Word. get_app11 897 | Бесплатная | HelpScribble — Простая в использовании утилита для создания файлов помощи. С ее помощью вы можете делать WinHelp (.hlp) файлы, HTML Help (.chm) файлы, руководства и онлайн документацию. get_app12 226 | Условно-бесплатная | Удобный инструмент для создания различной электронной документации в формате Word и CHM, включая руководства, справочники, книги и пр. Имеется встроенный WYSIWYG-редактор, возможность проверки орфографии «на лету», подключение дополнительных словарей и пр. get_app1 626 | Условно-бесплатная | CHM Editor — удобная программа для работы с CHM файлами, которые используются при создании файлов помощи к программам и электронных книг. С помощью программы можно создавать новые документы, редактировать уже созданные. get_app15 675 | Условно-бесплатная | HelpCruiser предназначен для создания документов в различных форматах, таких как HTML, CHM, PDF, RTF и XML. Помогает решить задачи, возникающие в процессе создания файлов помощи, описаний и справочных систем для программного продукта. get_app8 386 | Условно-бесплатная | OneClickHelp — утилита, позволяющая без особых усилий создавать различные справочные материалы и электронные книги посредством конвертирования документов подготовленных при помощи MS Word в форматы Chm, Aspx, HxS, Web, Html. get_app4 781 | Условно-бесплатная | get_app16 065 | Условно-бесплатная | CHM Builder 2010 — бесплатная и простая в использовании программа, которая предназначена для создания CHM-файлов (компилированных HTML-документов). get_app7 043 | Бесплатная | Syntext Serna Free — довольно мощный, при этом бесплатный, XML редактор который поможет вам при создании документов различных форматов, таких как техническая документация, руководства пользователя, статьи, книги, листинги программ. get_app14 050 | Бесплатная | Источник: www.softportal.com Как сделать справку к программе Любое программное обеспечение, которое выпускается сегодня, включает в себя обязательный пункт – справочный раздел. Какой бы легкой не была программа, к ней должна прикладываться инструкция. Разработчик программы при ее создании продумывает создание справочного файла. На данный момент хорошо зарекомендовали себя справочные издания, которые можно изготовить при помощи специальных программ. Вам понадобится Программное обеспечение Microsoft HTML Help Workshop. Инструкция 1. После установки данной программы запустите ее. В главном окне программы вы увидите новый чистый документ именно в таком виде, какой он будет при его чтении. В главном окне программы вы увидите вкладки Project, Index, Contents, а также Help. Для изменения общих настроек вашего проекта воспользуйтесь вкладкой Project. Вкладка Contents — для создания оглавления или содержания. Вкладка Index — для создания основной страницы файла. Вкладка Help вам не пригодится, поэтому ей не надо пользоваться. 2. Для установки правильных значений настроек главной страницы необходимо нажать кнопку Change project options, затем в новом окне ввести заголовок вашего проекта, а также выбрать исполняемый файл по умолчанию (Default file). Выбираемый вами файл должен присутствовать в списке FILES. 3. Вам необходимо внести все данные о программе, к которой изготавливается данная справка, затем приступить к компиляции данных. После нажатия кнопки Compile HTML file начнется операция компиляции. Эта кнопка находится на главной панели инструментов, а также в меню File (пункт Compile). До выполнения процесса компиляции файла справки, сохраните свой проект, потому как случаи бывают разные, вы можете потерять несохраненный документ. 4. Итоговым действием будет проверка получившегося файла справки. Теперь вы можете добавить полноценный справочный файл к вашей программе. Источник: expressa.top