- In order to generate documentation in CHM format, you must first download and
install Microsoft's HTML Help Workshop compiler. This free compiler allows you . - Microsoft Compiled HTML Help is a Microsoft proprietary online help format,
consisting of a collection of HTML pages, an index and other navigation tools. - Это библиотека, которая позволит вам добраться до HTML кода. Для использования ее нужно подключить. gif/118_1.gif (5452 b). Поместим на форму в.
- All HTML Help downloads are now available from the Microsoft.com Download
Center. Note The latest version of the HTML Help technology is 1.4, as is the . - . Download the Microsoft HTML Help Workshop and documentation.
HTML Help Workshop: инструмент для авторской разработки справочных файлов, имеющий легкий для использования графический. FrontPage — устаревший WYSIWYG-редактор HTML, входивший в состав пакета приложений Microsoft Office. Данное приложение при разработке.
Как создать CHM файл (HTM2. CHM и HTML Help Workshop в действии)CHM - это расширение файла в формате Compressed HTML Help. Формат был разработан Microsoft для гипертекстовых справочных систем. Для просмотра CHM файлов достаточно наличия в системе Internet Explorer. У CHM файлов, как правило, есть Содержание - отдельная панель со списком статей для упрощения навигации. В наличии содержания, пожалуй и заключается главное отличие CHM файлов от использовавшихся ранее HLP файлов справки Windows. Несколько человек интересовались процессом создания моего учебника по автоматической установке Windows в формате CHM, а в двух словах это не описать.
Изложенное ниже руководство применимо к созданию любого CHM файла, обладающего древовидной структурой отображения страниц в содержании, индексом, полнотекстовым поиском с поддержкой логических операторов и возможностью добавления страниц в избранное. Рассказ отражает мой личный опыт, и не исключено, что есть более простой путь (особенно при использовании специализированных и недешевых программных продуктов). Предполагается, что все HTML страницы, которые вы хотите включить в CHM уже подготовлены: в них работают все внутренние ссылки и отображаются картинки и прочие объекты. Речь в рассказе пойдет в основном о создании и компиляции CHM файла. Давид и Голиаф (HTM2. CHM и HTML Help Workshop)Для создания оффлайн версии сайта использовались две бесплатные программы: Microsoft HTML Help Workshop и HTM2.
CHM. По ходу рассказа я объясню, почему не удалось обойтись лишь одной из них. HTM2. CHM - маленькая программа, написанная Ярославом Кирилловым. Программа обладает русским интерфейсом и интуитивно понятна. Если вы не планируете снабжать свой CHM файл полнотекстовым поиском и индексом, a расширенные настройки внешнего вида CHM файла вам не нужны, то наверное не стоит городить огород с HTML Help Workshop.
Создать файл Содержания и выстроить страницы в желаемом порядке, назначив им различные иконки можно и в HTM2. CHM. Мне же возможностей этой программы не хватило - я посчитал, что для почти сотни страниц учебника нужен полнотекстовый поиск, а также не помешает индекс. Поэтому пришлось задействовать HTML Help Workshop - творение программистов Microsoft. В отличии от HTM2. CHM, программа не очень интуитивно понятна и русского интерфейса у нее тоже нет.
Зато функционально она меня устроила всем, кроме того что не сумела корректно сформировать файл содержания из кириллических заголовков страниц. В заключение этого мини- сравнения хочу сказать, что у HTML Help Workshop получился намного более компактный учебник (у HTM2. CHM размер выходного файла оказался в 1. Итак, перейдем к делу.
Я изложу тонкости создания CHM в файла том порядке, в котором я создавал свой учебник. Рассказ о HTML Help Workshop будет длинным, но лишь потому, что первый раз требуется указать много настроек проекта (в дальнейшем изменить уже имеющийся проект намного проще). Давид (HTM2. CHM) Работа с программой не должна вызвать затруднений даже у чайников - настолько все понятно и просто. Я рассмотрю создание содержания и компиляцию CHM файла. Создание содержания. Содержание - это фактически обязательная часть любого CHM файла. На этой закладке отображается список статей (страниц), входящих в файл.
Будет ли этот список линейным или древовидным, зависит от структуры информации и в каком виде вы ее хотите преподнести читателю. За содержание отвечает файл с расширением . HHC, который иногда для краткости именуют TOC файлом (Table of Contents).
С создания TOC файла мы и начнем. Как правило, названия статей для содержания генерируются из заголовков HTML страниц (тег TITLE). Для создания исходного файла содержания я как раз и использовал HTM2. CHM, поскольку мне не удалось преодолеть проблему некорректного отображения кириллицы в TOC файле, сгенерированном HTML Help Workshop. Создание файла содержания в HTM2. CHM - дело нехитрое.
Запускаем HTM2. CHM и видим список режимов работы программы. Выбрав Содержание, мы попадаем в окно генератора содержания, в котором нужно указать папку с HTML файлами, а также имя и расположение результирующего TOC файла. После генерации файла содержания откроется редактор, в котором все статьи, вошедшие в содержание будут отображаться вертикальным линейным списком. HTM2. CHM позволяет отсортировать статьи в алфавитном порядке автоматически или сделать это вручную.
Названия статей можно редактировать, а также назначать статьям индивидуальные иконки. Отмечу, что создание древовидной структуры и назначение иконок можно сделать и в HTML Help Workshop, однако в HTM2. CHM это реализовано поудобнее. Например, в HTM2. CHM для перемещения статей можно просто перетаскивать их мышью или делать это с нажатой клавишей CTRL, что намного удобнее, чем тыкать курсором в кнопку, перемещая за раз всего на одну позицию. Иконки тоже назначаются легко - трудно придумать что- то проще, чем выпадающее меню (у HTML Help Workshop смена иконки находится в свойствах страницы, да еще и на второй закладке). Короче говоря, я рекомендую привести файл содержания к желаемому виду в HTM2.
CHM, а уж если вам понадобятся дополнительные настройки CHM файла, то использовать для этого HTML Help Workshop. Компиляция. После того как файл содержания готов, можно переходить к компиляции CHM файла. В главном окне программы жмем большую кнопку Создать. И заполняем все поля, не забывая про только что созданный файл содержания. Через несколько секунд у вас будет готовый CHM файл.
К сожалению, HTM2. CHM не обладает возможностью создания полнотекстового поиска (или я не нашел такой опции), так что покончив с Содержанием, я продолжил работу над CHM файлом в HTML Help Workshop, в котором мне также открылись и другие возможности. Голиаф (HTML Help Workshop) За неказистым (и иногда не очень удобным) интерфейсом HTML Help Workshop скрывается очень мощный инструмент создания CHM файлов. Насколько мне известно, у программы нет русского лица (однако, русификаторы существуют), да и английский интерфейс не слишком информативен - иконки не имеют подписей и пока их не "выучишь", приходится наводить курсор мыши для получения всплывающей подсказки. Однако, функционально HTML Help Workshop превосходит HTM2. CHM. Я опишу лишь те функции программы, которые использовал сам. Вообще, HTML Help Workshop снабжен достаточно подробной справкой (EN).
Создание нового проекта. Первое что нужно сделать - это создать новый проект (File New). Выбираем Project и нам открывается мастер создания проекта. На первом этапе предлагается конвертировать существующий Win. Help проект. Поскольку мы ничего не конвертируем, то флажок ставить не надо. Указываем имя файла проекта (*. HHP) и папку, в которой он будет сохранен.
На этом этапе можно указать HTML файлы, которые мы включаем в проект, а также файл содержания и индекса (HHK). Я указываю только HTML файлы, а TOC файл, созданный в HTM2.
CHM, добавляю потом. Добавляем HTML файлы. И на этом работа мастера завершается. По завершении работы мастера левая часть рабочего окна HTML Help Workshop выглядит примерно так. Настройка внешнего вида Займемся настройкой будущего CHM файла. На своем опыте я уяснил, что сначала лучше настроить внешний вид, а потом уже остальные свойства проекта.
Итак, сначала определимся, какие закладки мы хотим видеть в навигационной панели (например, Содержание, Индекс, Поиск, Избранное), какие кнопки мы хотим видеть в верхней панели, настроим размер окна и т. В вертикальной панели инструментов HTML Help Workshop есть ряд иконок - нас интересует третья сверху (Add/Modify Windows Definitions). Если это ваш первый щелчок на иконку, то появится такое диалоговое окно, в котором нужно напечатать Navigation Pane. Нам откроется окно Window Types, в котором можно выставить немало настроек. На закладке Navigation Pane нужно отметить следующее: Window with navigation pane, topic pane, and button - обязательно ставим флажок, чтобы навигационная панель отображалсь в скомпилированном CHM файле. Поставив флажок, мы видим остальные опции. Тabs - закладки навигационной панели.
Default Tab - активная закладка по умолчанию (при открытии файла)Search Tab и Advanced - закладка поиска и возможность расширенного поиска с использованием логических операторов. Favorites tab - закладка Избранное.
Закладка Buttons контролирует какие кнопки будут доступны на верхней панели скомпилированного файла. Выбор оставляю на ваше усмотрение. Закладка Position позволяет задать размер окна и его расположение на экране.
Рекомендую дать пользователю возможность автоматически запомнить размер и позицию после первого запуска CHM файла (Save user defined window position after first use). Можете также поиграть с кнопкой Autosizer. На закладке Files указываем ряд важных файлов: Window - фокус по умолчанию при запуске (я выбираю Навигационную панель)TOC - файл содержания.
Здесь я указываю файл, который ранее создал в HTM2. CHM (путь нужно указывать, если только TOC не в одной папке с файлом проекта)Index - индексный файл (если вам нужен индекс - впишите туда index.
Default - страница, отображаемая при открытии CHM файла. Home - домашняя страница (кнопка Home на панели)Остальные закладки диалогового окна Window Types изучите самостоятельно. Свойства проекта Чтобы попасть в свойства проекта, делаем двойной щелчок на слове [Options] (в левой верхней части главного окна программы под закладкой Project) и идем по закладкам по порядку. Может я не уловил логики программы, но мне показалось, что часть настроек дублируются. Т. е. ниже вы увидите некоторые настройки, которые мы уже установили, ковыряясь во внешнем виде. На закладке General нас интересуют: Title - название CHM файла (отображается в заголовке окна скомпилированного файла)Default File - страница (статья), которая отображается при открытии CHM файла. Default Window - я выбираю Navigation Pane (навигационная панель с закладками в левой части CHM файла)Language - Russian (обязательно, если в Содержании кириллица)На закладке Files мы указываем следующие параметры: Compiled File - имя и расположение скомпилированного файла.
Contents File - вот тут я и указываю TOC файл, созданный в HTM2.