公司的寫作軟件是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的簡單使用，關于自定義參數設置，還在學習當中。

? ?

總結

以上是生活随笔為你收集整理的xml源文件的文档生成工具--DITA Open Toolkit（DITA-OT）的使用入门的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。