最近需要学习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”即可。