使用DITA-OT发布一份CouchBase Server文档

Posted 2020-09-10 学点技术

最近需要学习CouchBase Server。而CouchBase Server官方网站访问速度非常慢，所以尝试使用DITA-OT发布一份本地文档。（其实CouchBase Server官网上的文档也是用DITA-OT发布的。）

DITA Open Toolkit简称DITA-OT，是一款基于DITA标准的文档的发布工具。DITA-OT的官方文档参见http://www.dita-ot.org/dev/getting-started/installing-

client.html。

我在下载DITA-OT软件的时候，下载了好几次都没有下载成功。所以只能先一个编译DITA-OT，再

发布CouchBase Server文档。如果你能顺利下载DITA-OT，可以直接跳过编译DITA-OT的步骤。

步骤1、安装JDK或JRE
官网下载路径：http://www.oracle.com/technetwork/java/javase/downloads/index.html
JRE是JAVA的开发环境，而DITA-OT是JAVA语言编写的。所以，如果要编译DITA-OT源码，必须安装
JRE。如果只是运行DITA-OT这种JAVA程序，安装JDK即可。其实JAVA我不懂……

步骤2、配置JAVA环境变量
网上这种教程有很多，比如
http://jingyan.baidu.com/article/9f63fb91d87fb0c8400f0e93.html

步骤3、编译DITA-OT
下载源代码，进行本地编译，github路径：https://github.com/dita-ot/dita-ot
根据README.markdown完成本地编译。

步骤4、发布CouchBase Server文档
下载CouchBase Server文档源代码，github路径：https://github.com/couchbase/docs-cb4

进入clone到本地的DITA-OT源码所在目录（比如我的是“cd /d/work/DITA-OT/dita-ot”），执
行发布命令：

src/main/bin/dita -f html5 -i /d/work/doc/docs-cb4/content/cb-docs.ditamap -o
~/tmp/output/

使用资源管理器打开目录C:\Users\[用户名]\tmp\output，使用浏览器打开index.html即可查看
到刚刚发布出的本地CouchBase Server文档。如果想发布成PDF格式的文档，将发布命令中
的“html5”改为“pdf”即可。