版权所有,转载请注明来源http://gogo1217.iteye.com,违者必究!
最近准备把团队的文档编写工具从word迁移到docbook,这么做的出于几个原因:
- 团队的文档编写水平参差不齐,大家的细致程度不一样,虽然有统一的规范模板,但是总是得不到统一:要不忘记图片的样式,要不忘记了目录的刷新,等等。
- 示例代码不能语法高亮,如果希望语法高亮,需要从IDE编辑器中拷贝出来,还得将文字的字体重新编辑下。
- 图片的标号在文档结构目录调整后,还得重新编号
- 写文档很多时间花费在格式的统一上,写完文档后,除了要校正文档内容,还得校正文档格式,管理上比较麻烦。
- XML比较容易纳入版本控制,而且对比差别比较方便。
- 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及以上。
使用的时候注意:
- 需要自定义属性 docbook.xsl.path 指向本目录
- 需要加入外部字体 TimesNewRoman、SimHei和SimSun
- 需要拷贝 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)
相关推荐
docbook 最新的xsl
1 docbook-xsl-ns-1.75.2.zip解压到D:\docbook 2 另外四个压缩包解压出来,把里面的bin,include和lib三个文件夹拷贝到D:\docbook\xsltproc目录下 2 环境变量Path中增加 D:\docbook\xsltproc\bin 3 新建一个bat,...
XSL-Stylesheets Source: DocBook-XSL-1.79.1
XSL-Stylesheets Document: DocBook-XSL-1.79.1
适用于想要使用DocBook XSL样式表发布DocBook XML文件的人员的指南。 提供访问DocBook的全部功能所需的详细信息。
在编译mosquitto时将用到这个包
dbcookbook:DocBook和DocBook XSL样式表的食谱
asciidoctor-fopub, 可以移植的DocBook到PDF构建命令,它包装 DocBook XSL和 asciidoctor-fopub使用自由软件实现DocBook-to-PDF转换 ! ( 基于 DocBook XSL和 Apache FOP )可以使用 asciidoctor fopub项目将任何...
docbook-style-xsl-1.75.2-6.el6.noarch.rpm
DocBook XSL Configurator 是一个包含三个 Java (Swing) 应用程序的伞形项目,用于创建 DocBook XSL 自定义层(FO、HTML 和 Manpages),然后执行外部子流程以转换 DocBook XML 并查看输出。
该项目已移至GitHub:https://github.com/tomschr/dbcookbook/ DoCookBook项目旨在创建有关DocBook和以菜谱形式编写并在Creative Commons许可下发行的DocBook XSL样式表的开源书。
docbook2asciidoc, 将DocBook转换为AsciiDoc的XSL 这是将 DocBook 4.5转换为 AsciiDoc插件的样式表,最初由 bjepson 启动。依赖项这个项目有一个模块 ( https://github.com/oreillymedia/docbook2htmlbook ) 。
离线安装包,亲测可用
XSL转换样式表。 这些样式表从DocBook(c)XML文档输出LaTeX代码。 需要最新版本的LaTeX2e。
离线安装包,亲测可用
离线安装包,亲测可用
docbook5-style-xsl-1.75.2-4.el6.noarch.rpm
关于的DocBook的资料, 本人看过,觉得很不错,讲解很详细,应该对想学习DocBook的人有些帮助
NULL 博文链接:https://macrochen.iteye.com/blog/255002