Docbook开发手记

版本:v2.4.5

Crifan Li

摘要

本文先简介了什么是Docbook,然后详细介绍了如何搭建中文的Docbook开发环境,再详细记录了Docbook开发过程中所遇到的各种注意事项和遇到的问题及解决办法,同时给出很多常见的Docbook中各种元素的示例代码,另外也记录了一些值得参考的Docbook相关的资料。

[提示]本文提供多种格式供:

HTML版本的在线地址为:

http://www.crifan.com/files/doc/docbook/docbook_dev_note/release/html/docbook_dev_note.html

有任何意见,建议,提交bug等,都欢迎去讨论组发帖讨论:

http://www.crifan.com/bbs/categories/docbook_dev_note/

2015-05-12

修订历史
修订 2.4.52015-05-12crl
  1. 添加一个问题解答:listitem in namespace encountered in listitem
  2. 添加一个qanda的示例代码
  3. 添加示例:合并单元格的表格
  4. 添加示例:chapter的xml域
修订 2.42013-10-09crl
  1. 完善了代码示例部分
  2. 更新整理了appendix附录部分,把最新的所有的book都整理进来了
  3. 添加了filename,screenco等示例代码
  4. 更新了所有的xml:id
  5. 添加示例代码:figure内包含2张mediaobject图片
  6. 添加示例代码:内嵌元素中的keycap
  7. 修正了个别的笔误,修改了部分细节内容,添加了引用reference
  8. 添加整理了:Docbook相关的资源和工具下载
  9. 添加了:Docbook相关的知识和概念
  10. 添加示例:programlisting和screen
  11. 添加示例:filename是后缀名
修订 1.12012-06-14crl
  1. 完成此文的框架
  2. 各个章节都已添加了一些基本的内容,关于参考资料的部分,已添加大部分内容
  3. 收集了一些常见问题及解决办法
  4. 分割成多个文件
  5. 添加了关于实体定义部分的介绍
  6. 添加了调试fo部分的内容
  7. 添加了如何搭建docbook环境
  8. 添加了什么是Docbook
  9. 添加了代码示例部分

表格清单

2.1. Docbook中id命名规则