当前位置: 首页 > 工具软件 > DocBook XSL > 使用案例 >

docbook自定义xsl

宗政元青
2023-12-01

版权所有,转载请注明来源http://gogo1217.iteye.com,违者必究!

 

最近准备把团队的文档编写工具从word迁移到docbook,这么做的出于几个原因:

  1. 团队的文档编写水平参差不齐,大家的细致程度不一样,虽然有统一的规范模板,但是总是得不到统一:要不忘记图片的样式,要不忘记了目录的刷新,等等。
  2. 示例代码不能语法高亮,如果希望语法高亮,需要从IDE编辑器中拷贝出来,还得将文字的字体重新编辑下。
  3. 图片的标号在文档结构目录调整后,还得重新编号
  4. 写文档很多时间花费在格式的统一上,写完文档后,除了要校正文档内容,还得校正文档格式,管理上比较麻烦。
  5. XML比较容易纳入版本控制,而且对比差别比较方便。
  6. word多人协作编写不是很方便。

使用docbook,使得文档编写工作更加关注文档内容和结构,而无需或者很少关注文档的格式;内置了丰富的标签,满足我们文档的编写,如:bookinfo、chapter、sect*、para、glossary、qandaset、programlisting,这点和HTML5新增标签类似,语义化强。

它的基本原理就是将XML通过xsl定义转化为特定的格式。

docbook是XML语法,因次可以使用文本编辑器编写,当然也可以使用 xmlmind xml editor 进行编辑。

关于docbook的更多介绍,大家可以查阅他的官方网站: http://www.docbook.org/

 

docbook的官方提供了一套默认的转换规则,但是这套规则不是很适合我们的格式规范。需要对他进行定制。

现在最新版本为docbook-xsl-1.78.1。

 

我们基于jboss-docbook-xsl,进行了大幅度修改,只保留了章节标题的设置,去掉了jboss语法高亮、页眉页脚等设置,需要使用fop1.0及以上。

使用的时候注意:

  1. 需要自定义属性 docbook.xsl.path 指向本目录
  2. 需要加入外部字体 TimesNewRoman、SimHei和SimSun
  3. 需要拷贝 docbook-xsl-1.78.1 和当前目录同级,即

    +config
    +-docbook-xsl-1.78.1
    +-bonc-docbook-xsl

 

其中:

默认提供的中文本地化语言文件中,章节中间的空格展现为#。

参考这位仁兄的办法,得到解决:http://blog.csdn.net/tanghw/article/details/6854323

 

 

具体直接看代码吧:docbook-xsl.zip (137.7 KB)

 

 

 

 

 类似资料: