xml源文件的文档生成工具--DITA Open Toolkit（DITA-OT）的使用入门

公司的写作软件是oxygen xml editor，但对于文档的生成一直百思不得其解，除了使用公司定制的发布工具，试过oxygen xml editor的transformation功能，生成的文档很不好看，也不知道怎么调整参数。

oxygen已经更新到19.0版本了，回头看Editor-UserManual才有点思路。

这里明确表明了，oxygen xml editor不带有文档生成工具，请安装tool chain工具来执行生成场景。

然后又有描述，文档生成场景由DITA Open Toolkit提供。

很高兴的是，这个工具还是免费的！

下面简单说下这个工具的使用。

1. 访问官网http://www.dita-ot.org/download 下载DITA OT 压缩包。

2. 解压压缩包后将文件夹最好放在C盘。

3. 根据doc文件夹中的userguide.pdf 来搭建运行环境。

    1）安装Java。

          需要注意的是，Java的安装不当会导致工具使用时报错，如tools.jar工具找不到之类。这个在userguide里并没有提到。安装Java时，会安装JDK和JRE这两个组件，两个组件需要分别安装在单个文件夹中，请在安装过程中注意选择。最新版本的Java貌似是自动分开放文件夹的，如下所示。

    2）为Java和DITA OT添加环境变量。

          右击PC上的“此电脑”图标，选择“属性->高级系统设置->环境变量(N)…”，找到环境变量Path并双击。添加“C:\dita-ot-3.0\bin”和“C:\Program Files\Java\jdk-9.0.1\bin”这两个环境变量。

           说明：当时我只添加DITA OT的环境变量，安装后有报错，根据报错信息查了下，最后补充了Java的环境变量。

4. 验证运行环境。

    打开cmd窗口，进入dita-ot-3.0的bin目录，输入“dita --version”命令。如果显示“DITA-OT version 3.0”，则表示环境搭建OK。

    下面给出我的运行截图，中间有个报错，之前运行是没有报错，不过好像也不影响运行结果。

    

5. 运行命令“dita --input=XX.ditamap --format=pdf2”，文档将生成在C:\dita-ot-3.0\bin\out目录下。

以上是关于DITA-OT的简单使用，关于自定义参数设置，还在学习当中。