Как использовать HTML Help Workshop при работе с проектом

Владимир Максимов

Необходимые программы
Декомпиляция (разборка)
Перевод
Компиляция (сборка)

Необходимые программы

Для перевода файла справки Visual FoxPro 9 с английского языка на русский, прежде всего, нужен сам этот файл справки. Этот файл называется dv_foxhelp.chm. И физически он располагается в корневой директории FoxPro. Если Вы устанавливали FoxPro в директорию по умолчанию, то это директория: C:\Program Files\Microsoft Visual FoxPro 9

Если же Вы сделали установку в какую-либо другую директорию, то в ней и ищите файл справки.
Если не помните, где это все находится, но файл справки у Вас работает из среды FoxPro, то узнать, где же находится файл справки можно по команде

?SET('HELP',1)

Кроме собственно файла справки необходима еще программа, при помощи которой мы будем осуществлять его разборку и последующую сборку. Для этой цели будет использована программа HTML Help Workshop.
Эта программа поставляется вместе с FoxPro на том же диске. Кроме того, Вы можете бесплатно скачать ее с сайта Microsoft. На сегодня (конец августа 2005 года) его можно взять здесь - http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp

Cайт Microsoft время от времени перестраивается и его ссылки меняются. Поэтому указанная ссылка может не существовать. В этом случае зайдите в раздел Download сайта Microsoft и в окне поиска введите название данной программы.

Вам следует скачать файлы

ИмяРазмерОписание
HtmlHelp.exe3426 KBдистрибутив программы
HelpDocs.zip1344 KBдокументация по программе
Всего4770 KB 

Декомпиляция (разборка)

Прежде, чем приступить к разборке файла справки, создайте отдельную директорию, куда скопируйте собственно файл справки dv_foxhelp.chm. Кроме того, создайте еще одну директорию (можно как поддиректорию в данной), где сохраните резервную копию все того же файла справки dv_foxhelp.chm. На всякий случай.

Теперь откройте программу 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.hhc11,19 МБ (1 250 939 байт)
файл dv_foxhelpK.hhk12,76 МБ (2 900 065 байт)
Папка html4 76636,6 МБ (38 434 382 байт)
Папка local169792 КБ (811 058 байт)
Всего4 93741,38 MБ (43 396 444 байт)

Следует только иметь в виду, что в этой таблице приведены физические размеры файлов. Т.е. их реальный размер. Но, в зависимости от файловой системы на Вашем компьютере, эти файлы могут занимать в несколько раз больше места. Именно из-за содержимого папки html - большое количество небольших по размеру файлов. Будьте готовы к тому, что 36,6 МБ папки html займут в несколько раз больше места на вашем жестком диске.

По окончании процесса декомпиляции следует закрыть приложение HTML Help Workshop и удалить файл dv_foxhelp.chm из той папки в которую были записаны результаты "разборки".


Перевод

Переводится будут те файлы, которые лежат в папке html. Чтобы не возникало проблем при последующей сборке файла справки, структура и название оригинальных файлов htm остаются без изменения. По сути, просто заменяется английский текст на русский.

Готовый, переведенный файл просто заменяет оригинальный английский файл в папке html для последующей компиляции.


Компиляция (сборка)

Откройте программу HTML Help Workshop и выберите пункт меню "File", подпункт "New". Создаем новый Project.

Воспользуемся Wizard для построения нового проекта, который откроется автоматически. На первой закладке нам делать нечего. Сразу нажимаем кнопку "Далее"

На следующей закладке надо указать имя нового ффайла проекта. Но, что более важно, директорию, в которой он будет расположен. Воспользуйтесь кнопкой "Browse" и выберите ту директорию, в которой лежит результат "разборки" файла справки. В качестве выбранного файла напишите dv_foxhelp.hhp. Т.е. имя файла проекта должно совпадать с именем будущего файла chm.

На следующей закладке Wizard построителя проекта поставьте "птички" в пунктах:

  • HTML Help tables contents (.hhc)
  • HTML Help index (.hhk)

Помечать пункт "HTML files (.htm)" - не надо. Дело в том, что программа HTML Help Workshop не может выбрать сразу несколько файлов. А добавлять по одному почти 5 тысяч файлов слишком утомительно.

На следующей закладке 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" следует пометить разделы:

  • Hide/Show
  • Back
  • Forward
  • Options
  • Print
  • Locate

Закладка "Files", кроме уже заполненных разделов "Window", "TOC", "Index" введите в разделах "Default" и "Home" один и тот же текст

html/e4bf4e99-e197-4b4c-879a-4ec3d29df1d9.htm

Закладка "Navigate Pane" в разделе "Tabs" пометьте все разделы

  • Seach Tab
  • Advanced
  • Favorites Tab

Все остальное можете заполнить по своему усмотрению, но это уже не обязательно. После того, как Вы нажмете кнопку "Ok" появиться сообщение Wizard о том, что не все настройки корректны. Соглашайтесь с Wizard и нажмите кнопку "Далее"

На следующей странице Wizard скажет, что Вы сделали установку "Seach Tab", но сам проект не имеет настройку "Compile Full-text information". Установите "птичку" в пункте "Compile Full-text information" и нажмите кнопку "Далее" и на следующем шаге кнопку "Готово"

Все. Новый проект готов к компиляции. Для этого надо нажать самую нижнюю кнопку слева "Save all files and compile". Или же последовательно выбрать пункт меню "File" подпункт "Save Project", а затем пункт меню "File" подпункт "Compile"

После компиляции просто замените старый файл dv_foxhelp.chm из поставки FoxPro на этот новый.