HTML Help Workshop это среда разработки справочных материалов на базе Microsoft Help. Приложение включает функциональный конструктор с интеграцией ActiveX компонентов. Поддерживается вставка html разметки, растровых файлов и скриптов на Visual Basic Scripting Edition и JScript языках создания сценариев. Позволяет генерировать интуитивные справочники с интерактивными разделами, активными ссылками, мультимедийными данными.
Программа разрешает просматривать и отлаживать результаты в отдельном блоке. Использует модуль для вставки всплывающих окон, активных инструментов поиска и навигации, компилирования, сборки файлов в единый справочник. Содержит подробный мануал по функциям и сценариям работы, с примерами написания скриптов.
Конструктор используется при работе с новыми приложениями, может выступать в качестве дополнения в сторонних инструментах разработки.
Скачать бесплатно полную русскую версию HTML Help Workshop с официального сайта без регистрации и смс.
Описание программы
Html help workshop является полезным приложением для работы со справочными файлами сайтов. Подходит для разработки авторских прав и защиты сведений. Для открытия системных справок в интернете используется инструмент браузера Microsoft Internet. Утилита предусматривает работу с языками программирования, включая ActiveX и Java.
Хтмл хелп воркшоп взаимодействует со следующими форматами документов:.іко,.jpeg,.txt,.png,.pdf,.dkw. С помощью утилиты можно вставлять гипертекст, разрабатывать окна рекламы с навигацией для любого сайта.
Небольшое программное обеспечение привлекает наличием быстрого буфера обмена, работой из трея.
Рекомендуем последнюю версию HTML Help Workshop скачать бесплатно без вирусов, рекламы, регистрации и смс с официального сайта.
Программа Microsoft HTML Help содержит инструменты для просмотра справочных файлов и связанных с ними компонентами справки, а также для авторской разработки справочных файлов от «Microsoft Corporation».
Сколь бы хороша по своим функциональным возможностям не была бы система, созданная программистом, ее нельзя будет назвать совершенной, если у нее не будет хорошей справочной подсистемы. Трудно переоценить значение хорошего описания. Спецификации, поставляемые в справочном руководстве, играют важнейшую роль в освоении сложных программных систем. К сожалению, почти никогда не бывает, чтобы сложная система выполняла все свои функции безошибочно, точнее сказать, должным образом реагировала на все возможные действия пользователя. Пользователям (но не разработчикам) следует признать, что идеальных систем не бывает и принимать это как должное. Для них важнее знать спецификации системы, которые бы точно описывали, при каких условиях система функционирует без ошибок, и здесь хорошая справочная система незаменима. Важным достоинством системы Office 2000 является то, что в ней собственной справочной системе уделено большое внимание. Не менее важно, что в Office 2000 входят разнообразные инструментальные средства, позволяющие при создании собственных офисных решений, предназначенных для решения задач пользователя, создать для такого решения справочную подсистему по образцу и подобию справочной системы Office 2000. Создание такой справочной подсистемы предполагает разработку:
Таким образом, можно видеть, что справочная подсистема многообразна и создание ее дело совсем не простое. Тем не менее, попробуем во всем этом разобраться и начнем с создания руководства по системе.
Замечу, что создание справочного руководства может быть вполне самостоятельной задачей, не связанной с разработкой конкретной программной системы. Справочники полезны и сами по себе.
Как создать руководство по системе?
Перечислим инструментальные средства, составляющие Microsoft HTML Help и используемые при создании справочного руководства:
Эта статья впервые была опубликована на сайте www.relib.com
Если вы когда-либо смотрели Справку в Internet Explorer (IE) последних версий, то наверняка задавались вопросом, как создать справочную систему для вашего приложения подобно этой? В этой статье рассказывается как сформировать систему html-справки, используя Microsoft HTML Help Workshop, и как вызвать из VB-приложения готовый справочный файл.
Рис.1. Три части окна Справки Internet Explorer 4.0.
HTML Help Workshop
Для создания файлов HTML Help вы можете использовать специализированный редактор HTML Help Workshop, созданный Microsoft. HTML Help Workshop доступен для загрузки на сайте Microsoft. В этой части показывается, как сделать простую справочную систему с использованием этого инструмента. Прежде чем начать, установите HTML Help Workshop на вашу машину и посмотрите табл.1, дающую пояснения к различным типам файлов, используемых в HTML Help.
Табл.1. Файлы, используемые в HTML Help.
Extension
Type
HHP
Help project
HHC
Table of contents
HHK
Index
CHM
Compiled Help
HTM
Individual Help
H
Header files
Создание проекта Справки HTML Help
Теперь откройте HTML Help Workshop и выберите в меню пункт File | New. В появившемся диалоговом окне New выберите Project и щелкните OK. Запустившийся Мастер Проекта (New Project Wizard) предложит вам выполнить ряд шагов для создания вашего проекта. Убедитесь, что проверили опцию HTML Files в окне New Project-Existing Files и прибавили ваши HTML-файлы к создаваемому проекту. Щелкните кнопку Finish, чтобы создать проект. Рисунок 2 показывает типичное окно HTML Help Workshop.
Рис.2. Окно редактора HTML Help Workshop.
Главное окно HTML Help Workshop состоит из четырех закладок: Проект, Содержание, Индекс, Справка и набора кнопок для каждой закладки. Вы можете использовать закладку Проект (Project), чтобы изменить параметры проекта, добавить или удалить файлы содержания, изменить настройки окна и установить параметры для HTMLHelp API. Установка настроек окна и HTMLHelp API важна для VB разработчиков. Мы покажем вам позже как установить эти параметры.
Добавление оглавления и индексных файлов
Файл оглавления определяет содержание, которое вы будете видеть в закладке Contents в будущем справочном файле. Оглавление обычно организовано в виде дерева с разделами, подразделами и страницами.
Чтобы добавить файл оглавления к вашему проекту щелкните закладку Contents (Оглавление) и увидите диалог Table Of Contents Not Specified. Выберите Create A New Contents File, чтобы создать пустую таблицу файла оглавления. Теперь вы сможете прибавить ваше содержание, используя кнопки Insert Heading и Insert Page. В диалоговых окнах, которые появляются, когда вы выбираете эти параметры, вы можете сопоставить HTML-файлы с разделами и страницами. Вы можете также редактировать, удалять или реорганизовывать ваши разделы и страницы, используя кнопки Edit, Delete и Move Selection.
Индексный файл содержит ключевые слова, которые вы видите, когда щелкаете закладку Index. Для добавления индексного файла к вашему проекту щелкните закладку Index и увидите диалог Index Not Specified. Выберите Create New Index и создайте пустой индексный файл. Вы можете прибавлять ключевые слова, использующие кнопку Insert A Keyword и сопоставлять HTML-файл с этим ключевым словом. Вы можете также редактировать, удалять или реорганизовывать ключевые слова, используя кнопки Edit, Delete и Move Selection.
Параметры окна и HTMLHelp API
Параметры окна позволяют вам определять вид справочного окна при запуске. Вы можете определить, какие кнопки показывать на Панели Инструментов, какие закладки показывать на Панели Навигации и устанавливать другие свойства, которые изменяют вид справочного окна.
Когда вы вызываете HTMLHelp API из VB, вы можете обратиться к этим свойствам и показывать справочное окно в различных стилях. Кликните закладку Project, затем кнопку Add/Modify Window Definitions. В окне Add A New Window Type введите MyWindow (или любое другое название) и щелкните OK. В диалоговом окне Window Type вы можете выбрать различные закладки, чтобы изменить кнопки, стили и т.д. Кликнув OK, будет создано новое определение окна.
Кнопка HTMLHelp API Information позволяет установить параметры контекстно-зависимой справки. Когда вы нажмете эту кнопку, вы увидите диалог HTMLHelp API information. Вы можете сопоставить файл заголовков, который определяет все контекстные идентификаторы, в закладке Map (Карта). Рис.3 показывает содержание типичного файла заголовков.
Вы можете использовать закладку Alias, чтобы сопоставить константы идентификаторов контекстной Справки, определенные в заголовке HTML-файла, как показано на рис.4. Когда вы вызываете HTMLHelp из VB с константой идентификатора контекстной Справки, вы можете показать нужную тему Справки, связанную с этой константой.
Рис.4. Сопоставление идентификторов с HTML-файлами в закладке Alias.
Вы можете также устанавливать «всплывающий» текст используя закладку Text Pop-ups. Подробнее об этой возможности смотрите в он-лайн Справке по HTML Help Workshop.
Компиляция вашего проекта Справки
Прежде, чем вы начнете компилировать, нажмите кнопку Change Project Options в закладке Project и выберите Default File для вашего проекта в закладке General. Вы можете также кликнуть закладку Files, чтобы изменить название скомпилированного файла или проверить оглавление и индексные файлы. Нажмите кнопку Save All Project Files And Compile, чтобы откомпилировать ваш файл.
По умолчанию, ваш откомпилированный справочный файл будет иметь то же самое название как файл проекта с расширением CHM. Если в течении компиляции в вашем проекте встретятся какие-либо ошибки вы увидите их в правом окне. После успешной компиляции вы сможете вызывать вашу Справку из VB.
Вызов Справки из VB
Использование класса CHelp
Следующий пример показывает, как вызвать метод Show в процедуре события Click кнопки cmdShow. Вы можете попробовать вызов с другими параметрами, чтобы управлять окном Справки.
Дополнительную информацию Вы можете получить в компании Interface Ltd.
Как создать CHM файл (HTM2CHM и HTML Help Workshop в действии)
Несколько человек интересовались процессом создания моего учебника по автоматической установке Windows в формате CHM, а в двух словах это не описать. Изложенное ниже руководство применимо к созданию любого CHM файла, обладающего древовидной структурой отображения страниц в содержании, индексом, полнотекстовым поиском с поддержкой логических операторов и возможностью добавления страниц в избранное. Рассказ отражает мой личный опыт, и не исключено, что есть более простой путь (особенно при использовании специализированных и недешевых программных продуктов). Предполагается, что все HTML страницы, которые вы хотите включить в CHM уже подготовлены: в них работают все внутренние ссылки и отображаются картинки и прочие объекты. Речь в рассказе пойдет в основном о создании и компиляции CHM файла.
Давид и Голиаф (HTM2CHM и HTML Help Workshop)
Итак, перейдем к делу. Я изложу тонкости создания CHM в файла том порядке, в котором я создавал свой учебник. Рассказ о HTML Help Workshop будет длинным, но лишь потому, что первый раз требуется указать много настроек проекта (в дальнейшем изменить уже имеющийся проект намного проще).
Давид (HTM2CHM)
Создание содержания
Как правило, названия статей для содержания генерируются из заголовков HTML страниц (тег TITLE). Для создания исходного файла содержания я как раз и использовал HTM2CHM, поскольку мне не удалось преодолеть проблему некорректного отображения кириллицы в TOC файле, сгенерированном HTML Help Workshop.
Выбрав Содержание, мы попадаем в окно генератора содержания, в котором нужно указать папку с HTML файлами, а также имя и расположение результирующего TOC файла.
После генерации файла содержания откроется редактор, в котором все статьи, вошедшие в содержание будут отображаться вертикальным линейным списком.
HTM2CHM позволяет отсортировать статьи в алфавитном порядке автоматически или сделать это вручную. Названия статей можно редактировать, а также назначать статьям индивидуальные иконки. Отмечу, что создание древовидной структуры и назначение иконок можно сделать и в HTML Help Workshop, однако в HTM2CHM это реализовано поудобнее.
Короче говоря, я рекомендую привести файл содержания к желаемому виду в HTM2CHM, а уж если вам понадобятся дополнительные настройки CHM файла, то использовать для этого HTML Help Workshop.
Компиляция
После того как файл содержания готов, можно переходить к компиляции CHM файла. В главном окне программы жмем большую кнопку Создать.
И заполняем все поля, не забывая про только что созданный файл содержания. Через несколько секунд у вас будет готовый CHM файл.
К сожалению, HTM2CHM не обладает возможностью создания полнотекстового поиска (или я не нашел такой опции), так что покончив с Содержанием, я продолжил работу над CHM файлом в HTML Help Workshop, в котором мне также открылись и другие возможности.
Голиаф (HTML Help Workshop)
Создание нового проекта
Выбираем Project и нам открывается мастер создания проекта.
На первом этапе предлагается конвертировать существующий WinHelp проект. Поскольку мы ничего не конвертируем, то флажок ставить не надо.
Указываем имя файла проекта (*.HHP) и папку, в которой он будет сохранен.
На этом этапе можно указать HTML файлы, которые мы включаем в проект, а также файл содержания и индекса (HHK). Я указываю только HTML файлы, а TOC файл, созданный в HTM2CHM, добавляю потом.
Добавляем HTML файлы. И на этом работа мастера завершается.
По завершении работы мастера левая часть рабочего окна HTML Help Workshop выглядит примерно так.
Настройка внешнего вида
Займемся настройкой будущего CHM файла. На своем опыте я уяснил, что сначала лучше настроить внешний вид, а потом уже остальные свойства проекта. Итак, сначала определимся, какие закладки мы хотим видеть в навигационной панели (например, Содержание, Индекс, Поиск, Избранное), какие кнопки мы хотим видеть в верхней панели, настроим размер окна и т.д.
Если это ваш первый щелчок на иконку, то появится такое диалоговое окно, в котором нужно напечатать Navigation Pane.
Нам откроется окно Window Types, в котором можно выставить немало настроек. На закладке Navigation Pane нужно отметить следующее:
Закладка Buttons контролирует какие кнопки будут доступны на верхней панели скомпилированного файла. Выбор оставляю на ваше усмотрение.
Закладка Position позволяет задать размер окна и его расположение на экране. Рекомендую дать пользователю возможность автоматически запомнить размер и позицию после первого запуска CHM файла (Save user defined window position after first use). Можете также поиграть с кнопкой Autosizer.
На закладке Files указываем ряд важных файлов:
Остальные закладки диалогового окна Window Types изучите самостоятельно.
Свойства проекта
Чтобы попасть в свойства проекта, делаем двойной щелчок на слове [Options] (в левой верхней части главного окна программы под закладкой Project) и идем по закладкам по порядку. Может я не уловил логики программы, но мне показалось, что часть настроек дублируются. Т.е. ниже вы увидите некоторые настройки, которые мы уже установили, ковыряясь во внешнем виде.
На закладке General нас интересуют:
На закладке Files мы указываем следующие параметры:
На этом начальную настройку проекта можно считать завершенной. Теперь можно уже переходить к компиляции. Если вас интересует создание индекса и исключение слов из поиска, то читайте дальше.
Создание индекса
Где-то в тексте справки к HTML Help Workshop мне встретилась фраза, что пользователи чаще обращаются к индексу, чем к поиску. Не знаю насколько это верно, но мне вообще хотелось иметь индекс, чтобы было все профессионально 🙂 Добавить ключевые слова для индекса в каждую страницу можно через интерфейс HTML Help Workshop или вручную в каждую страницу. Я изложу оба способа.
Добавление ключевых слов через интерфейс Workshop
Я, однако, избрал другой способ, и теперь уже точно не помню почему. Если память мне не изменяет, кириллические ключевые слова, добавленные через GUI, впоследствии некорректно отображались в CHM файле. Так что прежде чем наполнять индекс тысячами слов проверьте как у него дела с кириллицей 🙂
Внесение ключевых слов в HTML код
В код HTML страницы после тега BODY вносится следующий текст (приводится скриншот, т.к. данный HTML код вырезается скриптом сайта):
Непроизносимый набором символов лучше скопировать 🙂 Вообще, это одна строка, просто на скриншоте сделан перевод строки.
Ни один из способов особо быстрым не назовешь. Так или иначе приходится назначать ключевые слова страницам вручную, и как это автоматизировать непонятно. Если вам известен более простой способ, то я буду рад о нем узнать.
Исключение слов из полнотекстового поиска
Исключить слова из полнотекстового поиска можно, поместив их в обычный текстовый файл (одно слово на строку) и сохранив файл с расширением STP. В виде исключений я использовал слова, которые часто упоминаются на страницах, но вряд ли нужны при поиске. Фрагмент файла:
Не скажу, что мне удалось реально сэкономить на размере файла таким образом. Используя список на 70 слов я сэкономил 30 кб. Однако, для больших CHM файлов с длинным списком слов-исключений это вполне может иметь смысл.
Компиляция
Если у вас есть по крайней мере файл содержания и список страниц, можно попробовать запустить компиляцию и посмотреть, что получается. Делается это через меню File | Compile или по нажатию третьей кнопки слева на верхней панели инструментов.
Получаем предложение сохранить все файлы и показать скомпилированный файл по окончании компиляции. Через несколько секунд или минут (в зависимости от кол-ва материала и/или скорости компьютера) получаемый желаемый и любимый CHM файл. Смотрим что получилось. Если чего-то не хватает, проверяем настройки и компилируем снова.
Редактирование существующего проекта
Ну вот примерно такая картина наблюдается у меня на закладке Contents. Сразу видно, что файл содержания из HTM2CHM был принят как родной.
Слева панель инструментов, кнопки которой означают:
Допустим, нам нужно добавить статью. Нажимаем на иконку с изображением вопросительного знака (3) и видим диалог добавления статьи.
Здесь все делается в таком порядке:
Так победил ли Давид Голиафа?
Все зависит от поля боя 🙂 Я вот наоборот пытался их подружить. И в связке эти две программы неплохо сработали. Другое дело, что сгенерировав содержание в HTM2CHM, я больше к ней не возвращался, а продолжаю редактировать проект в HTML Help Workshop, но на то у меня были свои причины.
А вообще, создание CHM файла не такая уж и сложная задача. Простой CHM файл можно создать при помощи HTM2CHM за три-четыре минуты. Потом можно потратить еще час на доводку, если редактировать меню и баловаться иконками страниц. HTML Help Workshop займет побольше времени, особенно на начальном этапе. Однако разобравшись с настройками и меню, вы будете тратить совсем немного времени на создание более функциональных и компактных файлов.
Если у вас есть на примете другие бесплатные (и удобные) инструменты для создания CHM файлов, то я буду признателен за ссылки на сайты программ.
Если же Вы сделали установку в какую-либо другую директорию, то в ней и ищите файл справки. Если не помните, где это все находится, но файл справки у Вас работает из среды FoxPro, то узнать, где же находится файл справки можно по команде
Cайт Microsoft время от времени перестраивается и его ссылки меняются. Поэтому указанная ссылка может не существовать. В этом случае зайдите в раздел Download сайта Microsoft и в окне поиска введите название данной программы.
Вам следует скачать файлы
Имя
Размер
Описание
HtmlHelp.exe
3426 KB
дистрибутив программы
HelpDocs.zip
1344 KB
документация по программе
Всего
4770 KB
 
Декомпиляция (разборка)
Теперь откройте программу HTML Help Workshop и выберите в ней пункт главного меню File, подпункт Decompile.
В появившемся окне в разделе «Destination folder» укажите папку, в которую надо положить результат «разборки» файла справки. Укажите ту директорию, куда Вы скопировали файл справки
В разделе «Compiled help file» укажите тот файл, который и будет «разбираться». Т.е. собственно файл справки dv_foxhelp.chm
После чего, нажмите кнопку «Ok» и подождите некоторое время, пока программа осуществит «разборку» файла помощи. По окончании этого процесса должно появиться сообщение вроде:
4,937 files extracted from C:\Перевод\dv_foxhelp.chm
В результате, Вы должны получить в указанной папке:
Имя
Количество файлов
Размер
файл dv_foxhelp.hhc
1
1,19 МБ (1 250 939 байт)
файл dv_foxhelpK.hhk
1
2,76 МБ (2 900 065 байт)
Папка html
4 766
36,6 МБ (38 434 382 байт)
Папка local
169
792 КБ (811 058 байт)
Всего
4 937
41,38 MБ (43 396 444 байт)
По окончании процесса декомпиляции следует закрыть приложение HTML Help Workshop и удалить файл dv_foxhelp.chm из той папки в которую были записаны результаты «разборки».
Перевод
Переводится будут те файлы, которые лежат в папке html. Чтобы не возникало проблем при последующей сборке файла справки, структура и название оригинальных файлов htm остаются без изменения. По сути, просто заменяется английский текст на русский.
Готовый, переведенный файл просто заменяет оригинальный английский файл в папке html для последующей компиляции.
Компиляция (сборка)
Откройте программу HTML Help Workshop и выберите пункт меню «File», подпункт «New». Создаем новый Project.
Воспользуемся Wizard для построения нового проекта, который откроется автоматически. На первой закладке нам делать нечего. Сразу нажимаем кнопку «Далее»
На следующей закладке Wizard построителя проекта поставьте «птички» в пунктах:
На следующей закладке Wizrad укажите файл оглавления dv_foxhelp.hhc
На следующей закладке Wizrad укажите файл индекса dv_foxhelp.hhk
На последней закладке Wizard просто нажмите кнопку «Готово»
Файл проекта создан, но теперь надо сделать кое-какие дополнительные настройки этого проекта
Нажмите в левом столбце 3-ю сверху кнопку «Add/Modify window defenitions». В появившейся форме введите имя нового окна dv_foxhelp и нажмите кнопку «Ok»
Появиться окно настройки в котором следует сделать следующие назначения:
Закладка «General» в разделе «Title Bar Text» введите «Microsoft Visual FoxPro 9 Русский перевод»
Закладка «Buttons» следует пометить разделы:
Закладка «Files», кроме уже заполненных разделов «Window», «TOC», «Index» введите в разделах «Default» и «Home» один и тот же текст
Закладка «Navigate Pane» в разделе «Tabs» пометьте все разделы
Все остальное можете заполнить по своему усмотрению, но это уже не обязательно. После того, как Вы нажмете кнопку «Ok» появиться сообщение Wizard о том, что не все настройки корректны. Соглашайтесь с Wizard и нажмите кнопку «Далее»
На следующей странице Wizard скажет, что Вы сделали установку «Seach Tab», но сам проект не имеет настройку «Compile Full-text information». Установите «птичку» в пункте «Compile Full-text information» и нажмите кнопку «Далее» и на следующем шаге кнопку «Готово»
Все. Новый проект готов к компиляции. Для этого надо нажать самую нижнюю кнопку слева «Save all files and compile». Или же последовательно выбрать пункт меню «File» подпункт «Save Project», а затем пункт меню «File» подпункт «Compile»
