公司的写作软件是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的简单使用,关于自定义参数设置,还在学习当中。

   


Logo

魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。

更多推荐