wiki:DitaOtInstallation

Установка DITA Open Toolkit (под Windows)

Идем на страницу

http://sourceforge.net/projects/dita-ot/

и решаем, какую версию DITA OT брать.

Самая последняя версия - 1.4. Но при работе с ней возникают какие-то глюки. На тестах, поставляемых с этой версией, все работает. Но на некоторых других проектах сооружение "падает". Наверное, надо подождать выпуска 1.4.1?

Поэтому берем версию 1.3.1. Для работы под Windows для работы под Windows выкачиваем DITA-OT1.3.1_fullpackage_bin.zip. Выбираем папку, имя которой не содержит пробелов, и распаковываем в нее содержимое zip-архива. Если, например, выбрали папку C:\Applications, то DITA OT окажется в папке C:\Applications\DITA-OT1.3.1. Пробелов в именах папок следует избегать в тех случаях, когда используются программы, портированные из-под Юникса, либо программы, рассчитанные на работу на нескольких платформах.

Находим в папке DITA-OT1.3.1 файл startcmd.bat и кликаем по нему. Открывается окно Command Prompt, через которое можно запускать ant-скрипты для генерации выходных документов из DITA-документов.

Если попытаться вызывать ant-скрипты из произвольного окна Command Prompt, то ничего работать не будет! Посмотрим, что находится в файле startcmd.bat (окромя копирайтной информации).

REM Get the absolute path of DITAOT's home directory
set DITA_DIR=%~dp0

Это означает, что переменная окружения DITA_DIR устанавливается на папку DITA-OT1.3.1, т.е. получает значение вроде C:\Applications\DITA-OT1.3.1\ (обратите внимане на \ в конце.

set ANT_OPTS=-Xmx512m %ANT_OPTS%

Переменная окружения ANT_OPTS содержит опции для ant-а, и к ней добавляется -Xmx512m. Это означает, что когда ant-будет запускать задачи, он будет указывать Java-машине, что максимальный размер "кучи" - 512 мегабайт. Без этого, DITA OT может "упасть" при обработке больших документов.

set ANT_HOME=%DITA_DIR%tools\ant
set PATH=%DITA_DIR%tools\ant\bin;%PATH%

Вместе с DITA OT поставляется и версия ant-а, с которой он нормально работает. Если использовать другую версию ant-а, то неизвестно, что из этого получится. ANT_HOME устанавливается на "домашнюю" папку ant-а, а в PATH включается папка, в которой лежат исполняемые файлы ant-а.

set CLASSPATH=%DITA_DIR%lib;%DITA_DIR%lib\dost.jar;%DITA_DIR%lib\resolver.jar;%DITA_DIR%lib\fop.jar;%DITA_DIR%lib\avalon-framework-cvs-20020806.jar;%DITA_DIR%lib\batik.jar;%DITA_DIR%lib\xalan.jar;%DITA_DIR%lib\xercesImpl.jar;%DITA_DIR%lib\xml-apis.jar;%DITA_DIR%lib\icu4j.jar;%CLASSPATH%

Установка CLASSPATH выглядит жутковато, но на самом деле все сводится к тому, что к CLASSPATH добавляется сама папка %DITA_DIR%lib, а также jar-файлы, которые в ней лежат.

Возникает вопрос: а зачем включать в CLASSPATH саму папку %DITA_DIR%lib, если в ней нет ни одного class-файла? Ответ - такой. В этой папке лежит файл CatalogManager.properties, который DITA OT в какой-то момент пытается читать, используя API, через который обычно происходит загрузка class-файлов. Если папка %DITA_DIR%lib не включена в CLASSPATH, все сооружение "падает" (в какой-то момент). И поди-ка догадайся в чем дело...

start "DITA-OT" cmd.exe

Сия строчка запускает отдельное окно Command Prompt, которое наследует только что сделанные установки переменных окружения. В этом окне и следует работать с DITA OT. Запускаем в этом окне, для проверки

ant -f build_demo.xml

и следуем инструкциям.

Last modified 13 years ago Last modified on Sep 13, 2007, 8:17:33 PM