DocBook学习

修订版本 1.6.7

本文档还在不停地写作、完善中,如果你有什么建议请与limodou联系。

本教程提供源码下载,大家可以下载源码在你的机器上进行测试。关于下载及转换见附录 A, 关于本教程

本文档版权所有者为limodou。你可以自由发布,引用,拷贝,但要保留此版权声明。

感谢 leasun 指出2.5节和2.16的错误。

特别感谢 1.6.6 版是在老康的帮助下完成的,不仅有好的建议,还帮助我改进了许多地方。

感谢 xuejm 指出2.5节的错误。

感谢 jxb 指出2.5节的错误。

感谢 Alex Dong 指出3.1节的错误。


目录

从这里开始学习DocBook
1. DocBook Book 结构
1.1. 一个Book示例
1.2. 多个物理文档
1.3. 块元素 vs. 环境
2. 常见环境介绍
2.1. 章、节、段
2.2. 使用entity做为宏替换
2.3. 例子
2.4. 图形
2.4.1. 使用figure环境
2.5. 代码片段
2.6. 屏幕输出
2.7. 编号图形
2.8. 脚注
2.9. 列表
2.9.1. 无序列表
2.9.2. 有序列表
2.9.3. 定义列表
2.10. 表格
2.10.1. 表格基础
2.10.2. 横向融合
2.10.3. 纵向融合
2.11. 处理过程
2.12. 链接
2.13. 块引用
2.14. 常见inline元素
2.15. 附录
2.15.1. 术语表
2.15.2. 参考书目
2.15.3. 修订历史
2.16. 警告信息
3. 输出HTML
3.1. 环境准备
3.2. xslt参数的使用
3.2.1. 在命令行中指定参数
3.2.2. 在驱动样式表中使用参数
3.3. 使用Saxon进行转换
3.4. docbook.xsl 还是 chunk.xsl
3.5. 本教程所用样式表参数解释
3.6. 中文处理
3.6.1. 编码
3.6.2. 调整相关xslt参数
3.7. 编辑DocBook文档
3.8. 关于输出要注意的其它问题
3.8.1. images目录
3.8.2. 常见的问题
3.8.3. CSS文件
3.8.4. UTF-8编码
A. 关于本教程
B. 文档修订历史
C. 常用术语
D. 参考书目