INF2HTML V0.92 - Конвертор файлов помощи от OS/2 в HTML формат
Автор: Ulrich MФller.
Портирование под Win32: Maxim Vidyuk.
Отладка и документация: Valery Votintsev.
Компилятор: VC++6.0, BC++5.0, Win95 или выше
ВВЕДЕНИЕ
INF2HTML - это небольшая консольная утилита для Win32,
которая преобразует стандартные файлы справки системы OS/2 (.INF или .HLP)
в набор HTML файлов, причем кажая отдельная страница справки (панель)
преобразуется в отдельную HTML страницу.
INF2HTML автоматически создает ссылки между страницами,
что позволяет легко просматривать полученный HTML код с помощью
любого HTML браузера.
INF2HTML вставляет в выходной код специальные, не стандартные для HTML
тэги и атрибуты, которые игнорируются браузером, но зато позволяют
произвести преобразование из полученного HTML в IPF-код с помощью
утилиты HTML2IPF от Андрея Заболотного. IPF-код, в свою очередь,
является исходным материалом для компиляции файлов справок в
операционной системе OS/2.
КОМПИЛЯЦИЯ
INF2HTML v0.92 нормально компилируется под Visual C++ v6.0
и Borland C++ v5.0.
ИСПОЛЬЗОВАНИЕ
По умолчанию, INF2HTML создает подкаталог с именем исходного файла,
и помещает в него сформированные HTML файлы. Например, если входной
файл имел имя "CMDREF.INF", то будет создан подкаталог "CMDREF".
Каждому HTML файлу присваивается имя следующего вида:
<idx>_L<level>_<title>.html
где:
<idx> - индекс в оглавлении исходного файла;
<level> - уровень в оглавлении исходного файла (1 для самого первого
уровня в оглавлении);
Если страница (панель) не показывается
в оглавлении, то к уровню добавляется буква "H" (hidden);
<title> - начало текстового заголовка страницы (примерно 20 символов).
Кроме того, INF2HTML создает дополнительный HTML файл с именем входного
файла, содержащий оглавление входного INF файла.
INF2HTML перезаписывает выходные HTML файлы без предупреждения!
ПАРАМЕТРЫ
Для получения справки о параметрах командной строки просто введите
"INF2HTML".
Например, вы можете задать имя выходного каталога, отличающееся от
формируемого по умолчанию.
Кроме того, задание параметра "-F" позволяет сформировать HTML страницы
с фреймами, причем в левом фрейме будет показываться полное развернутое
оглавление сформированного HTML документа. Контейнер для фреймов
формируется в файле с именем "index.html". При этом все страницы будут
иметь правильные ссылки с указанем нужного фрейма в качестве TARGET.
INF2HTML может создавать дополнительные ссылки на следующую/предыдущую
страницы ("Next"/"Back") при указании параметра "-n" или "-N".
При задании параметра "-b", INF2HTML будет формировать файлы картинок
в стандартном для OS/2 V1.3 несжатом виде (BMP).
Для просмотра этих картинок в стандартном браузере необходимо преобразовать
их в формат GIF, JPG или PNG с помощью любой графической утилиты.
В системе OS/2 для этого существует небольшой REXX скрипт ("BMP2GIF.CMD").
INF2HTML по умолчанию вставляет в HTML тэги <IMG ...> на картинки с расширением
GIF.
ПРИМЕЧАНИЕ:
Для версии 0.92 для Win32 эта возможность отключена!
Там есть функция BOOL DecodeINFBitmap().
Поскольку она не исправлена под винды, то в ее начале
просто поставлен return.
Пример вызова утилиты:
INF2HTML -vFnNa CMDREF.INF
REVISION HISTORY
V0.92 (Sep. 14, 2002)
---------------------
-- Converted to Win32 for VC++6.0
-- Removed bitmap decoding (temporarily).
V0.91 (Nov. 10, 1998)
---------------------
-- Added bitmap decoding.
-- Added additional tags for window positioning, which
are not part of default HTML and should thus not
hurt.
V0.90 (Nov. 10, 1998)
---------------------
Initial release.
ИЗВЕСТНЫЕ ПРОБЛЕМЫ
INF2HTML не разбирается с кодовыми страницами,
а вставляет текст в той кодировке, которая использована
в исходном INF файле.
Из-за этого, например, могут возникнуть проблемы отображения,
если в исходном тексте используются графические символы
из стандартной ASCII таблицы.
Поскольку в HTML не реализована возможность автосвязывания ссылок
на файлы других типов (в частности, на файлы справок INF и HLP),
то вы можете получить в результате несколько пустых страниц
вместо ссылок на другие файлы справок.
Задание параметра "-a" в командной строке позволяет сформировать
"настоящие" ссылки на другие INF файлы.
ЛИЦЕНЗИЯ и АВТОРСКИЕ ПРАВА
Copyright (C) 1998 Ulrich MФller.
Эта программа относится к классу "свободно распространяемых".
Вы можете распространять или модифицировать ее в соответствии
с лицензией GNU General Public License, приведенной в файле
"COPYING" в этом архиве.
Мы надеемся, что программа INF2HTML окажется для вас полезной,
однако мы НЕ ДАЕМ НИКАКИХ ГАРАНТИЙ; используйте программу
AS IS, на свой страх и риск.
БЛАГОДАРНОСТИ
Спасибо Питеру Чилдсу (Peter Childs), Австралия, за статью
"Inside INF" в журнале EDM/2, vol. 3 no. 8, в которой приведена
информация о структуре INF файлов.
Описание формата из этой статьи приведено в файле "inf03.txt"
в подкаталоге "source".
Огромное спасибо Питеру Фицсимонсу (Peter Fitzsimmons, pfitz@ican.net)
за код для декомпрессии битмапов (V0.91).
КОНТАКТНАЯ ИНФОРМАЦИЯ
Ulrich MФller
e-mail: ulrich.moeller@rz.hu-berlin.de
www: http://www2.rz-hu-berlin.de/~h0444vnd/os2.htm
Maxim Vidyuk
e-mail: m_e_g@pisem.net
aka: "MeG" at Sources.Ru Forum
(http://pascal.sources.ru/cgi-bin/forum/YaBB.cgi)
Valery Votintsev
e-mail: rswag@sources.ru
aka: "vot" at Sources.Ru Forum
(http://pascal.sources.ru/cgi-bin/forum/YaBB.cgi)
Downloads
Скачать исходник - 233 Kb
|