l2h

Работаем с ковертором LaTeX2HTML в пакете MiKTeX20e!

Способы конвертирования LaTeX-статей в HTML-формат обсуждаются на страничке "TeX+HTML", где рассказано о наших "наработках" в этом направлении.

В Институте нескольких лет успешно используется конвертор LaTeX2HTML Никоса Дракоса ( вариант под ОС LINUX), отслеживаются его версии.

Примеры практического использования конвертора:

1. Страничка "TeX в ИММ" подготовлена только средствами конвертора LaTeX2HTML.

2. Страничка "Список научных трудов сотрудника"(с научными статьями).

3.Пример слайда для показа при проведении доклада(с исп. slides.sty).

4.Пример слайда для показа при защите диссертации(с исп. slides.sty).

5.Пример руководства.

6.Пример инструкции.

7. Электронные публикации ИММ(возможно, не очень оптимальный вариант, т.к. готовились давно, использовались старые версии конвертора (1996 г. - 1997 г.)).

Версия latex2html-99.2beta6 успешно развернута и адаптирована в пакете MiKTeX20e( WiN95, WiN98) (локальный и сетевой варианты).

Она же успешно используется на Alphe под LiNuX.

Установка конвертора LaTeX2HTML с использованием сетевого пакета MiKTeX20e и дополнительных сетевых программных модулей
Установка локальной версии LaTeX2HTML
Установка локальной версии LaTeX2HTML для имеющих доступ к сетевому диску T:

При установке конвертора в пакете MiKTeX20e за основу была взята заметка Installing LATEX2HTML with MiKTEX. Luis Seidel G'omezde Quero.

Желающие использовать конвертор с сетевой версией пакета MiKTeX20e должны:

1. Скопировать каталог t:\emtex\miktex20e\l2h на c:\l2h(и толко на диск c:\!).

2. В autoexec.bat прописать PATH:
PATH t:\Aperl\bin;c:\l2h\bin;%PATH%.

3. Для индивидуальных настроек использовать файл dot.latex2html-init, который следует скопировать из каталога c:\l2h в рабочий каталог и переименовать в .latex2html-init.

Переменные, установленные в .latex2html-init, переопределяют одноименные переменные файла глобальных настроек конвертора c:\l2h\l2hconf.pm.

Для корректировки настроек лучше скопировать переменные, которые необходимо изменить, из файла c:\l2h\l2hconf.pm в файл .latex2html-init, в котором и нужно произвести их переустановку.

4. Конвертор настроен на сетевой пакет t:\emtex\miktex20e, на сетевой t:\Aperl, сетевой пакет gs6.00 и сетевую библиотеку t:\netpbm.

5. Для вызова конвертора в рабочем каталоге следует выполнить команду:
latex2html ключи имя файла.tex.

После конвертирования здесь будет создан каталог имя файла, в котором будут размещены необходимые html-файлы и png-образы (или gif-образы, в зависимости от настроек).

При запуске конвертора в командной строке можно указать список ключей, которые переустановят параметры, указанные в файлах настройки.
Часть ключей конвертора, содержащих пробел (например, -html_version 3.2,math), не может быть набрана в командной строке FAR (NC, VC). Эти параметры следует изменять в конфигурационных файлах.

Про параметры конвертора и опыт использования можно прочитать в докладе.

При работе с конвертором можно использовать инструкцию. Учитывать, что инструкция подготовлена для использования версии под LiNuX на Alphe и некоторые моменты, отраженные в ней, (связь с удаленной машиной, перекодировка и др.) неактуальны для версии под WiN95.

Нужно помнить, что версия конвертора, работающая на Alphe, не занимает ресурсы вашей машины, работает быстрее и незаменима для подготовки html-версий больших по объему TeX-статей.

Для установки полностью локальной версии конвертора необходимо:
1. Развернуть на машине Perl.
Можно взять здесь.
2. Установить на машине библиотеку netpbm.
Или взять здесь.
3. Развернуть ghostscript-6.0.tar.gz. Или ghostscript-6.0.tar.gz взять здесь.
4. На машине должен быть корректно установлен MiKTeX20e.
5. Развернуть конвертор (распаковать модуль), скачав latex2html-99.2beta6.tar.gz или
latex2html-99.2beta6.tar.gz отсюда.
6. Проверить, чтобы были прописаны корректные пути в autoexec.bat на выше указанные программные продукты!
Например, PATH с:\Aperl\bin; c:\netpbm\bin; c:\miktex20e\miktex\bin; c:\gs5.50; %PATH%.
Следует учесть, что автоматически распознается только пакет Gs5.50.
Если на машине установлен помимо Gs5.50 Gs6.00 (несколько иная структура каталога), то прописать пакет в конфигурационных файлах придется вручную.
7. Внимательно прочитать инструкцию по установке конвертора Installing LATEX2HTML with MiKTEX. Luis Seidel G'omezde Quero .

Далее пошаговая установка:
1. Откорректировать строки:
123 и 129 файла prefs.pm, прописав нужные пути (описывается в инструкции).
Хотя, на практике, оказалось, что важнее правильно сформировать путь PATH в файле autoexec.bat, как указано выше.

2. Выполнить c:\latex2html-99.2beta6\config.bat. Происходит автоматическое распознавание программных компонент.
Процесс распознавания фиксируется на экране и в файле c:\latex2html-99.2beta6\config.log. После того, как на экране будут показаны строки


checking for dvips... C:\MIKTEX20e\MIKTEX\BIN\dvips.exe
checking dvips version...

следует нажать <enter>, чтобы выйти из паузы при определении версии dvips.
После отработки config.bat необходимо проверить config.log.
Корректный файл c:\latex2html-99.2beta6\config.bat при локальной установке всех компонент на диске C:\ можно скачать и просмотреть для сравнения с полученным.

3. Выполнить c:\latex2html-99.2beta6\test.bat. Если все компоненты установлены корректно, будет выполнен тест.

Html-версия теста будет размещена в каталоге c:\latex2html-99.2beta6\tests\l2htest, который должен содержать файлы: index.html, l2htest.html, 6 файлов node*.html, 2 png-образа (или gif-образа) и др.. Корректно отработанный тест можно просмотреть здесь и сравнить со своими результатами.

4. Запустить c:\latex2html-99.2beta6\install.bat. Результатом выполнения будет создание локального каталога c:\l2h(каталог c:\l2h прописан в строке 129 файла prefs.pm) и копирование корректно установленной версии конвертора из каталога c:\latex2html-99.2beta6 в этот каталог.

После копирования каталог c:\latex2html-99.2beta6 можно удалить.

Если вы хотите использовать не Ghostscript 5.50, а Ghostscript 6.00
(версия GS6.00 выручает при подготовке pdf-файлов),
то следует откорректировать:
* строку файла c:\l2h\cfgcache.pm:
$cfg{'GS'} = q'c:\\Aladdin\\gs6.0\\bin\\gswin32c.exe'
* строку файла c:\l2h\bin\pstoimg.bat:
my $GS = 'c:\\Aladdin\\gs6.0\\bin\\gswin32c.exe'.

Настраивать параметры работы конвертора аналогично рассказанному выше.

Для сотрудников ИММ (более простая установка), желающих локально установить конвертор и все программные модули, необходимые для его работы, можно:
1. Выполнить установку дополнительных компонент простым копированием уже установленных модулей из сети с диска T: в соответствующие локальные каталоги:
* t:\Aperl - c:\Aperl;

* t:\gs6.00 - c:\Aladdin\gs6.0;

* t:\netpbm - c:\netpbm;

* t:\emtex\miktex20e\l2hloc - c:\l2h

Локально должен быть корректно установлен пакет MiKTeX20e ( c:\MiKTeX20e)! (MiKTeX20e).

2. Добавить пути в autoexec.bat из t:\emtex\miktex20e\l2h\autoexec.bat.
3. Перезагрузить систему на машине.
4. Для проверки работоспособности:
- Войти в каталог c:\l2h\tests;
- Выполнить latex2html l2htest;
- Войти во вновь созданный каталог c:\l2h\tests\l2htest;
- Просмотреть index.html или l2htest.html;
- Сравнить результаты с c:\l2h\tests\l2htest1\index.html;

В случае неудачной попытки внимательно проверить пути (например, организовать поиск по "c:\") в следующих файлах:
c:\l2h\cfgcache.pm;
c:\l2h\l2hconf.pm;
c:\l2h\bin\latex2html.bat;
c:\l2h\bin\pstoimg.bat;
c:\l2h\bin\texexpand.bat;
c:\autoexec.bat.

В рабочий каталог скопировать файл c:\l2h\dot.latex2html-init, который следует переименовать в .latex2html-init.

Этот файл будет индивидуальным файлом настройки параметров при конвертировании вашей tex-статьи.

Он переопределяет переменные файла глобальных настроек c:\l2h\l2hconf.pm.

Например, для переключения языка для формирования корректных надписей в вашей русской html-статье (аннотация, секция, список рисунков, оглавление и т.п.) следует занести установку переменной $TITLES_LANGUAGE = "english" в ваш .latex2html-init и присвоить ей значение $TITLES_LANGUAGE = "russian".

Установку параметров конвертирования можно осуществить и с помощью ключей командной строки.

Запуск конвертора: latex2html [ключи] имя.tex

В результате конвертирования создается каталог с именем файла, который вы конвертировали. В этом каталоге размещаются результирующие html-файлы и png или gif образы ваших математических выражений и рисунов.

Если вы желаете выбрать свои пути для установки локальных компонент, после копирования вы должны очень внимательно откорректировать пути в следующих файлах:
c:\l2h\cfgcache.pm; c:\l2h\l2hconf.pm; c:\l2h\bin\latex2html.bat; c:\l2h\bin\pstoimg.bat; c:\l2h\bin\texexpand.bat; c:\autoexec.bat

Каталог t:\emtex\miktex20e\l2hloc\l2h содержит только установленную часть конвертора latex2html.
Дистрибутив (распакованный) размещен на t:\emtex\miktex20e\lat2hdistr.

Если есть трудности или Вы заметили неточности в инструкции по установке, звоните 5-37, 49-32-46, email: mnn@imm.uran.ru .