docbook自定义xsl

版权所有，转载请注明来源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)

 

 

 

 

评论

9 楼 gogo1217 2014-07-05  

http://gogo1217.iteye.com/blog/2088628

houyongbo03 写道

gogo1217 写道

1、为了保证上传文件的体积，没有包含docbook-xsl-1.78.1，所以需要额外的加入，放在同级
2、同时需要从操作系统中拷贝 TimesNewRoman、SimHei和SimSun这些字体
3、如果使用xxe(XML Editor)则需要设置字体变量指向上面的字体，以及设置转换变量 docbook.xsl.path为bonc-docbook-xsl所在的路径。
周末有空了我将写一篇xxe的使用吧。

houyongbo03 写道

请问这个包怎么用，怎么整合，能把整个工程共享一份吗？
另外“需要自定义属性 docbook.xsl.path 指向本目录”请问是什么意思？

太好了，期待中……

8 楼 houyongbo03 2014-07-03  

gogo1217 写道

1、为了保证上传文件的体积，没有包含docbook-xsl-1.78.1，所以需要额外的加入，放在同级
2、同时需要从操作系统中拷贝 TimesNewRoman、SimHei和SimSun这些字体
3、如果使用xxe(XML Editor)则需要设置字体变量指向上面的字体，以及设置转换变量 docbook.xsl.path为bonc-docbook-xsl所在的路径。
周末有空了我将写一篇xxe的使用吧。

houyongbo03 写道

请问这个包怎么用，怎么整合，能把整个工程共享一份吗？
另外“需要自定义属性 docbook.xsl.path 指向本目录”请问是什么意思？

太好了，期待中……

7 楼 gogo1217 2014-07-03  

已经共享到 github 上了，地址 https://github.com/gogo1217/docbook-xsl

houyongbo03 写道

请问这个包怎么用，怎么整合，能把整个工程共享一份吗？
另外“需要自定义属性 docbook.xsl.path 指向本目录”请问是什么意思？

6 楼 gogo1217 2014-07-03  

我没用过ant来做，只是使用了maven，这个变量应该没有定义过，是不是你自己的文档本身的问题？

houyongbo03 写道

用ant运行的时候报：
    [xslt] : Fatal Error! org.apache.xml.utils.WrappedRuntimeException: 找不到名为 use.simplified.author.group 的变量 Cause: org.apache.xml.utils.WrappedRuntimeException: 找不到名为 use.simplified.author.group 的变量
     [xslt] Failed to process null

BUILD FAILED

5 楼 gogo1217 2014-07-03  

1、为了保证上传文件的体积，没有包含docbook-xsl-1.78.1，所以需要额外的加入，放在同级
2、同时需要从操作系统中拷贝 TimesNewRoman、SimHei和SimSun这些字体
3、如果使用xxe(XML Editor)则需要设置字体变量指向上面的字体，以及设置转换变量 docbook.xsl.path为bonc-docbook-xsl所在的路径。
周末有空了我将写一篇xxe的使用吧。

houyongbo03 写道

请问这个包怎么用，怎么整合，能把整个工程共享一份吗？
另外“需要自定义属性 docbook.xsl.path 指向本目录”请问是什么意思？

4 楼 houyongbo03 2014-07-02  

用ant运行的时候报：
    [xslt] : Fatal Error! org.apache.xml.utils.WrappedRuntimeException: 找不到名为 use.simplified.author.group 的变量 Cause: org.apache.xml.utils.WrappedRuntimeException: 找不到名为 use.simplified.author.group 的变量
     [xslt] Failed to process null

BUILD FAILED

3 楼 houyongbo03 2014-07-01  

请问这个包怎么用，怎么整合，能把整个工程共享一份吗？
另外“需要自定义属性 docbook.xsl.path 指向本目录”请问是什么意思？

2 楼 jxyangzi 2014-05-22  

我整合了doobook4j和XFC，可导出PDF,HTML,RTF(docbook4j也可导出RTF，但效果不是很好)，另外XFC，还可导出docx和odt格式

1 楼 jxyangzi 2014-05-22  

谢谢，你提供的XLS，很不错！

另外，想知道怎么去掉 TOC CONTENT，即目录？