使用CDBE写DocBook注意的几个问题

最新推荐文章于 2024-03-22 16:15:59 发布

最新推荐文章于 2024-03-22 16:15:59 发布 · 466 阅读

文章标签：

#velocity #Windows #HTML #XML

本文介绍使用Docbook撰写专业文档的经验分享，包括安装配置CDBE工具、解决汉字支持问题及图片处理技巧等内容。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

使用Docbook写文档，是一件非常有成就感的事情。它最大的特点就是：让你写的东西看起来非常专业。嘿嘿。

之前一直苦于Docbook对于汉字的不支持。Velocity也有个docbook项目，可惜对汉字支持的也不好。07年底我发现了CDBE这个项目。非常赞！感谢作者，现在提供的链接仍然有效。

[url=http://wiki.woodpecker.org.cn/moin/CDBE]CDBE的下载地址[/url]

1. CDBE的安装
CDBE的手册中写道：

[quote]安装CDBE十分简单，它是一个.zip压缩包。
首先将其解压缩到适当位置，建议解压缩到D:\obp\目录下。
执行 install.bat 文件。[/quote]

实际上，执行完这一步之后，还需要您修改 CDBE目录下的bat/config.bat文件的
docbook_base_path这个变量，使它指向正确的安装位置：

[quote]set docbook_base_path=D:\obp[/quote]

这样就好了。

2. Docbook中注意的几个问题。

图片放在 src/figure目录下，而不是figures. 否则会找不到。
图片对于pdf格式的输出，统一会压缩成542宽度。对于HTML则是原大小。
所有的xml文件请使用UTF-8编码。GBK的不会成功。
对于程序代码，建议使用literallayout标签，而不是 programlisting。因为后者的输出中，汉字会变成乱码。
如何让图片的title居中（pdf格式）： imagedata align="center"
html的字体，跟windows画图中的12号字体等大。

3. docbook手册：
建议看这里：[url]http://www.docbook.org/tdg/en/html/docbook.html[/url]