wiki:DitaOtAndEclipseLaunchConfiguration

Конфигурация для запуска ant-сценария под Эклипсом

В принципе, чтобы узнать, как следует изготовить конфигурацию для исполнения сценария в файле build.xml, достаточно изучить файл startcmd.bat, лежащий в домашней папке DITA OT (см. Установка DITA Open Toolkit (под Windows)). И воспроизвести то, что делается в этом файле в пусковой конфигурации Эклипса.

Настройка переменной окружения DITA_DIR

До запуска Эклипса в Windows должна быть установлена переменная окружения DITA_DIR. Её значение должно указывать на папку, в которой находится DITA OT. Например, если домашняя папка DITA OT лежит внутри папки c:\Applications, DITA_DIR должна получить значение c:\Applications\DITA-OT1.3.1\.

Создание новой пусковой конфигурации

Для создания новой пусковой конфигурации выбираем в меню Эклипса

Run | External Tools | Open External Tools Dialog

Открывается панель диалога. В дереве конфигураций слева выбираем узел Ant Build, кликаем по нему правой кнопкой и выбираем в контекстном меню пункт New. Создается новая пусковая конфигурация.

Настройка виртуальной машины

Поскольку DITA OT может "поедать" много памяти при генерации результирующей документации, лучше запускать для этого отдельную виртуальную Java-машину.

  • Выбираем закладку JRE.
  • Выбираем вариант Separate JRE и ту версию JRE, которая нам больше нравится. (Например, ту, под которой работает сам Эклипс.)
  • В окошке VM Arguments вводим -Xmx512m, что означает, что максимальный размер "кучи" установлен в 512 Mb.

Настройка CLASSPATH

  • Выбираем закладку Classpath.
  • Чтобы не зависеть от того, какая версия ant-а поставляется с Эклипсом, настраиваемся на ту версию ant-а, которая поставляется с DITA OT. Для этого нажимаем кнопку Ant Home и выбираем папку tools\ant в домашней папке DITA OT.
  • Добавляем в CLASSPATH папку lib из домашней папки DITA OT. Для этого нажимаем на кнопку Add Variable и добиваемся, чтобы в открывшемся окошке получился текст ${env_var:DITA_DIR}/lib. Можно ввести его руками, а можно использовать кнопку Variables.
  • Добавляем в CLASSPATH все jar-файлы, лежащие в папке lib из домашней папки DITA OT. Для этого выбираем в дереве узел User Entries и нажимаем кнопку Add External Jars. После этого выбираем все jar-файлы из папки lib.

Настройка множества проектов, которые нужно строить

  • Выбираем закладку Build.
  • Ставим галочку Build before launch.
  • Выбираем вариант The project containing the selected resource.
  • Ставим галочку Include referenced projects.

Эти настройки делаем, поскольку построение документации обычно не требует построения каких-либо других проектов.

Настройка режима освежения проекта

  • Выбираем закладку Refresh.
  • Ставим галочку Refresh resources upon completion.
  • Выбираем The project containing the selected resource.

Автоматическое освежение полезно, поскольку благодаря ему автоматически сгенерированные файлы становятся видны в дереве проекта.

Настройка пути к файлу build.xml

Выбираем закладку Main. После этого заполняем окошко Buildfile.

Здесь возможны два варианта.

  • Если мы хотим иметь конфигурацию, которая строит конкретный проект, например, org.refal.plus.rfpdt.help.manual, то в окошко следует ввести
    ${workspace_loc:/org.refal.plus.rfpdt.help.manual/build.xml}
    
  • Если мы хотим, чтобы наша пусковая конфигурация работала для нескольких проектов (для проекта, который выбран в окне Navigator в данный момент), то в окошко следует ввести
    ${project_loc}/build.xml
    
Last modified 13 years ago Last modified on Oct 20, 2007, 10:24:02 PM