版权所有,转载请注明来源http://gogo1217.iteye.com,违者必究!
最近准备把团队的文档编写工具从word迁移到docbook,这么做的出于几个原因:
- 团队的文档编写水平参差不齐,大家的细致程度不一样,虽然有统一的规范模板,但是总是得不到统一:要不忘记图片的样式,要不忘记了目录的刷新,等等。
- 示例代码不能语法高亮,如果希望语法高亮,需要从IDE编辑器中拷贝出来,还得将文字的字体重新编辑下。
- 图片的标号在文档结构目录调整后,还得重新编号
- 写文档很多时间花费在格式的统一上,写完文档后,除了要校正文档内容,还得校正文档格式,管理上比较麻烦。
- XML比较容易纳入版本控制,而且对比差别比较方便。
- word多人协作编写不是很方便。
使用docbook,使得文档编写工作更加关注文档内容和结构,而无需或者很少关注文档的格式;内置了丰富的标签,满足我们文档的编写,如:bookinfo、chapter、sect*、para、glossary、qandaset、programlisting,这点和HTML5新增标签类似,语义化强。
它的基本原理就是将XML通过xsl定义转化为特定的格式。
docbook是XML语法,因次可以使用文本编辑器编写,当然也可以使用 xmlm