2005-08-12

第一次用DocBook

写文档经历了三个阶段,用Word,然后用HTML,现在开始尝试DocBook。

The Art of Unix Programming的第18章Documentation介绍了几种写文档的工具,DocBook是其中一种,在这一节的最后,作者提到DocBook: The Definite Guide is indeed the definitive reference, but as an introduction or tutorial it's a disaster. Instead, read this: Writing Documents Using DocBook. This is an excellent tutorial.

我读了后者,半天就够了,最多一天就可以读完,都是一些简单的例子。读完后试着写了一个最简单的例子,然后用xmlto把xml文件转成html文件。DTD和StyleSheet文件在Fedora和Cygwin下都有,只要把路径写对就没问题了。具体配置参见mickeyrat写的安装配置Docbook工具。当然,如果用emacs的话肯定离不开PSGML Mode

没有评论: