Фролова доклад. Программы для создания helpфайлов, их функционал, сравнение
 Скачать 1.19 Mb.
|
|
Microsoft HTML Help. Формат HTML Help обеспечивает объединение "в одном флаконе" основных достоинств рассмотренных выше форматов. С одной стороны, он поддерживается операционной системой Windows, может считаться стандартным и практически не требует дополнительного изучения со стороны пользователя. С другой стороны он позволяет применять при создании справочника практически все возможности языка HTML. Но есть один недостаток: средство просмотра справочника в формате HTML Help базируется на компонентах Интернет-браузера Internet Explorer версии 4 и выше (точнее требует файла Shdocvw.dll). Отсюда отсутствие на компьютере пользователя указанного программного средства делает работу со справочником невозможной. Кроме того, все пользовательские настройки браузера наследуются и программой HTML Help Viewer. И все-таки формат HTML Help можно считать на сегодняшний день наиболее распространенным форматом справочников для вновь создаваемых Windows-приложений. Для операционных систем Windows 2000 и выше этот формат объявлен компанией Microsoft стандартом электронный справочных систем 32-разрядных Windows-приложений. Исходным материалом, "сырьем" для создания справочника в формате HTML Help служат HTML-файлы. При этом каждый раздел справочника генерируется на основе отдельного HTML-файла. В вою очередь, исходный HTML-файл может содержать любые объекты (сценарии, элементы ActiveX, мультимедийные элементы), поддерживаемые HTML. Из графических объектов HTML Help поддерживает JPEG и GIF (В том числе прозрачный и анимированный форматы GIF). Из мультимедийных форматов в HTML Help разрешено использование форматов AVI, MOV, AU, WAV, MID, RMI. Гиперссылки, имеющиеся в исходном HTML-файле, могут указывать не только на аналогичные файлы-разделы, но и на внешние ресурсы (например, на веб-страницы в Интернете, адреса электронной почты и др.). При этом формат HTML Help позволяет создавать для вызываемого раздела дополнительное (вторичное) окно либо с теми же возможностями, что и основное окно справочника, либо с ограниченными возможностями. После компиляции исходных HTML-файлов справочник в формате HTML Help представляет собой единый файл с расширением CHM (от Compiled HTML). Размер такого файла оказывается существенно меньше суммарного объема исходных HTML-файлов и связанных с ними внешних файлов (графических, таблиц CSS и т.д.). Попутно он поможет создать исходный файл оглавления (.hhc), файл индекса ключевых слов справочника (.hhk) и базу данных для полнотекстового поиска. Важным отличием пакета HHW от его предшественника является то, что он позволяет декомпилировать готовый продукт (CHM-файл) и получить исходные файлы в первозданном виде (текстовые файлы, HTML, мультимедиа и т.д.) Также, пакет HHW способен автоматически конвертировать справочник из формата WinHelp в формат HTML Help, сохраняя при этом в работоспособном состоянии оглавление, указатель ключевых слов и базу полнотекстового поиска. HHW, как и Help Workshop, вполне корректно работает с кириллицей. Правда, возможны некоторые проблемы при конвертировании в формат HTML Help русскоязычного справочника, созданного ранее в формате WinHelp. HelpScribble. Программа HelpScribble создана компанией JGSoft. Оценочную версию программы можно загрузить с веб-сайта компании (www.helpscribble.com). Она имеет некоторые функциональные ограничения, в частности, в каждый раздел справочника помещается уведомление о том, что он создан с использованием trial-версии программы. Программа HelpScribble в определенной степени поддерживает технологию единственного источника: она позволяет получать справочную систему в форматах WinHelp и HTML Help, а также выполнять экспорт содержимого справочника в RTF- и/или HTML-файлы. Тем не менее в основном программа HelpScribble ориентирована на подготовку справочника WinHelp. Для генерации HLP- и CHM-файлов HelpScribble использует соответствующие компиляторы от Microsoft, которые разработчик справочника должен предварительно установить на свой компьютер самостоятельно. Поскольку при попытке первой компиляции справочника HelpScribble начинает сканировать все жесткие диски компьютера в поисках компилятора. Поэтому надо сначала указать пути до компилятора: (Options/Compilator). Достоинством HelpScribble можно считать наличие развитых средств редактирования текста в формате RTF. При этом авторское решение по визуальному представлению редактируемого текста достаточно оригинально: элементы разметки, относящиеся к основному RTF-формату, остаются скрытыми, а элементы разметки, относящиеся к подмножеству Help RTF, отображаются на экране. Вся информация о создаваемом справочнике хранится в файле проекта HelpScribble (.hsc). AnetHelp Tool. Инструмент AnetHelp Tool создан российской компанией Anet Soft. Демонстрационная версия продукта (которая отличается от рабочей только тем, что при запуске напоминает о необходимости зарегистрироваться) доступна на сайте компании (www.anetsoft.com). Программа AnetHelp Tool (AHT), как и HelpScribble, поддерживает технологию единого источника: она позволяет получать электронную справку в форматах WinHelp, HTML Help и Java Help, а также выполнять экспорт содержимого справочника в RTF-, HTML- и/или XML-файлы. При этом уровень поддержки формата HTML Help здесь существенно выше, чем в HelpScribble. Для генерации HLP-и CHM-файлов AHT использует компиляторы от Microsoft. Причем в дистрибутив входят не только компиляторы, но и полностью приложения Help Workshop и HTML Help Workshop (в некоторых случаях разработчик справочника получает доступ к их интерфейсу из среды АНТ). Следует отметить удобные средства экспорта справочника в формат RTF, которые позволяют выбрать, экспортировать весь справочник в один файл или создать для каждого раздела отдельный файл. Операция экспорта в АНТ имеет одну существенную особенность: при генерации исходного файла АНТ убирает из RTF-кода элементы разметки, относящиеся к подмножеству Help RTF. Благодаря этому вы получаете документ, пригодный для самостоятельного использования (например, для вывода на печать). Однако при этом он не может более служить сырьем для генерации справочника. АНТ позволяет также экспортировать разделы справочника в HTML-файлы. АНТ поддерживает механизм шаблонов, которые позволяет быстро создавать однотипные разделы справочника. В комплект поставки АНТ входит набор из десятка шаблонов, предназначенных для описания приложения на уровне программных компонентов. Начиная работать с AnetHelp Tool, необходимо сразу создать резервную копию файла проекта (.mdb). Дело в том, что вносимые в проект изменения сразу переносятся в файл. Если отмена выполненного действия окажется невозможной (например, в случае создания неперемещаемой области), то восстановить предыдущее состояние проекта не удастся. Именно по этой причине AnetHelp Tool не запрашивает о необходимости сохранения проекта перед выходом из приложения. Help And Manual. Оценочная версия программы находится на сайте разработчика, компании EC Software, по адресу www.helpandmanual.com. Оценочная версия работоспособна в течении 14 дней. Имеется ещё одно ограничение: при генерации справочника в формате HTML Help некоторые гипертекстовые ссылки заменяются ссылками на сайт разработчика. С помощью этого пакета можно получить справочник в трех форматах: WinHelp, HTML Help и WebHelp (разработчики HelpAnd Manual именуют его Brouser Based Help). Кроме того, возможен экспорт справочника в PDF-файл и в файл формата текстового редактора Word (.doc или .rtf). И наконец, пакет Help And Manual способен создавать электронные книги (electronic book). Такая книга внешне очень похожа на справочник в формате HTML Help, но представляет собой самостоятельное Windows-приложение (EXE-файл). Формат электронной книги имеет один существенный недостаток, - он не очень компактен (но вполне пригоден для распространения дополнительных обучающих материалов на компакт-дисках). Пакет HelpAnd Manual использует для генерации справочников в форматах WinHelp и HTML Help компиляторы от Microsoft, однако прямого доступа к интерфейсу Help Workshop и HTML Help Workshop разработчик справочника не имеет. Следует отметить, что в дистрибутив входит программа Help Workshop, а вот HTML Help Workshop предполагается получить на сайте компании EC Software. Если же этот инструмент уже установлен на компьютере, следует указать его расположение. Пакет HelpAnd Manual способен декомпилировать справочные файлы (.hlp и .chm) и создать на их основе новый проект. При создании русскоязычного справочника в формате WinHelp никаких дополнительных настроек выполнять не требуется. Перед генерацией CHM-файла необходимо указать используемый язык. Также, на сайте компании можно получить русский словарь, подключаемый к Help And Manual для проверки правописания текста разделов. Mif2GO Mif2GO- это не самостоятельное приложение, а подключаемый модуль, который может работать только совместно с пакетом Adobe FrameMaker. FrameMaker- это программа для верстки, ориентированная на создание документов большого объема, имеющих сложную структуру. В ней реализованы средства для автоматической нумерации таблиц и иллюстраций, построения оглавления и указателей. Кроме того, она поддерживает перекрестные ссылки и гипертекстовые связи, позволяет привязывать графику к абзацам текста и многое другое. Можно разделить документ на главы, собрать главы в книгу, и FrameMaker автоматически обновит номера страниц и ссылки независимо от того, каким образом переставлены страницы, главы или разделы. Для хранения документов FrameMaker использует собственный формат файлов (.fm и .book), однако в программе имеются средства, позволяющие экспортировать файлы в форматы PDF и HTML. Необходимо также отметить, сто программа FrameMaker изначально создавалась для подготовки технических описаний систем вооружения (в частности, авиационной техники), а также верстки текстов, требующих частого обновления (каковой является документация к программному обеспечению). Пакет Mif2GO разработан компанией Omni Systems, и для отдельных категорий пользователей(не корпоративных технических писателей, студентов изучающих FrameMaker, и некоторых других) распространяется бесплатно. На сайте компании (www.omsys.com) доступна также демо-версия пакета. Она является полнофункциональной, за исключением того, что при генерации справочника отдельные фрагменты текста заменяются случайным образом строками из стихотворения Льюиса Кэролла "Jabberwocky". Mif2GO позволяет создавать справочники в пяти форматах: WinHelp, HTML Help, OmniHelp (собственный кроссплатформенный формат справочной системы компании Omni Systems, аналогичный формату WebHelp), Oracle Help и JavaHelp. Для генерации выходных файлов в перечисленных форматах требуется наличие на компьютере соответствующих компиляторов, которые не входят в дистрибутив Mif2GO и должны устанавливаться отдельно. Собственно говоря, для подключения Mif2GO к FrameMaker установка как таковая не требуется. Достаточно скопировать файлы из дистрибутива в папки, указанные в инструкции по установке. В качестве исходных данных для создания справочников WinHelp и HTML Help программа Mif2GO использует файлы в форматах RTF и HTML. Однако прежде, чем ни будут получены из собственных файлов FrameMaker (.fm и .book), должен пройти многоэтапный процесс преобразований. RoboHelp. RoboHelp - это целое семейство продуктов, выпускаемых компанией eHelp Corporation. Возможны три варианта комплектации. Enterprise. Этот вариант включает единственный продукт RoboHelp Enterprise, который позволяет создавать справочную систему в одноименном формате. Его существенное отличие от всех форматов, рассмотренных выше, состоит в том, что он предполагает наличие серверной и клиентской части справочной системы. Серверное программное обеспечение, основанное на использовании сервера IIS (Internet Information Server) от Microsoft, позволяет отслеживать действия пользователя, работающего со справочной системой. Благодаря этому разработчик может получить весьма ценные статистические данные об интересах пользователей. Формат клиентской части справки аналогичен формату WebHelp. Professional. Этот вариант включает набор инструментов под общим наименованием RoboHelp Office. В набор Professional входят: RoboHelp HTML - приложение, предназначенное для создания справочных систем на основе языка HTML и позволяющее генерировать справочники в форматах WebHelp, Microsoft HTML Help, JavaHelp и Oracle Help for Java; RoboHelp Classic - приложение, специализирующееся на подготовке справочников в формате WinHelp, в том числе в модифицированном формате WinHelp 2000; RoboHelp Tools - дополнительные сервисные приложения, призванные облегчить работу автора справочника (в том числе Software Video Camera - приложение, которое позволяет "снять" звуковой видеофильм о работе с приложением). Standart. Это облегченный вариант RoboHelp Office, который включает три инструмента: RoboHelp for Microsoft HTML Help - приложение для разработки справочных систем в формате HTML Help; RoboHelp for WinHelp - приложение для разработки справочных систем в формате WinHelp; RoboHelp for Word - приложение, которое позволяет создать справочники во всех стандартных форматах (WebHelp, Microsoft HTML Help, JavaHelp), но с одним ограничением: в качестве редактора разделов (в том числе HTML-файлов) с ним может использоваться только Microsoft Word. Для работы с исходными форматами данных (RTF - для WinHelp и HTML - для HTML Help) RoboHelp по умолчанию использует Microsoft Word, однако для создания разделов справочника он подключает собственные шаблоны, в значительной степени автоматизирующие процесс редактирования. MS Word нельзя считать идеальным инструментом для создания файлов в форматах RTF и HTML, поскольку выходные файлы содержат избыточные теги. Но если для работы с RTF альтернативы нет, то для подготовки разделов в RoboHelp HTML модно подключать любой HTML-редактор. При разработке с помощью приложения RoboHelp HTML возможно не корректное отображение кириллицы. Т.к. изначально в RoboHelp Office не предусмотрена поддержка русского языка. Вместе с тем, RoboHelp практически не изменяет параметры RTF-файла, созданного в Word. Поэтому при генерации справочника в формате WinHelp языковые проблемы достаточно редки. При создании справочной системы в формате HTML Help проблемы с корректным отображением кириллицы (на этапе разработки справочника) более вероятны. Эта проблема может быть решена несколькими способами, в том числе посредством подключения к RoboHelp HTML внешнего HTML-редактора. HelpNDoc - мощная и удобная в использовании программа, с помощью которой можно быстро и легко создавать справочную документацию в разнообразных форматах, включая CHM, HTML, PDF или совместимых с Word. Присутствует интерактивная проверка орфографии, возможность визуального редактирования, генерация кода для различных языков программирования (C/C++, Delphi/Pascal, Fortran 90/95, Power Basic и Visual Basic), поддержка шаблонов и многое другое. Программа бесплатна для персонального использования.
 Devesar Book Editor — простая, но довольно мощная среда разработки руководств, справочников, книг и других электронных документов. Программа обладает интуитивно понятным интерфейсом, WYSIWYG-редактором, что позволяет экономить время и комфортно работать с текстом, не обращая внимания на технические аспекты. Возможности программы: удобная система управления содержанием документа; мощный WYSIWYG-редактор, позволяющий оформить документы, используя различные шрифты, абзацы, списки и другие элементы форматирования текст; проверка орфографии «на лету» на русском и английском языках, с возможностью подключения дополнительных бесплатных словарей; использование таблиц разного уровня сложности, в том числе и вложенные; быстрая вставка графических файлов популярных форматов (png, jpg, gif, bmp, tif), спецсимволов, разделительных линий и др. объектов; вставка ссылок и закладок для удобной навигации по разделам вашего проекта и внешним интернет-ресурсам; продуманный, современный «ленточный» интерфейс, аналогичный интерфейсу программ Microsoft Office; экспорт готовых документов в форматы CHM и DOCX (список доступных форматов будет пополняться) одной кнопкой и др.
 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||