DocBook 助你完成传世之作

文档的技术革命

修订历史
修订 2.3 2003/1/14 jiangxin
将Hello World部分内容作为样章,网络发布
修订 2.2 2002/12/11 jiangxin
重新规划文档结构,补充 DocBook 在实际中的应用
修订 2.1 2002/12/9 jiangxin
和国内某出版社联系,拟定写作计划。
修订 2.0 2002/09/29 jiangxin
补充Openjade的安装及使用
修订 1.2 2002/01/11 jiangxin
从编程规范中独立出来

摘要

DocBook 是当前风行于开放源码世界的一种文档撰写格式,已经成为计算机文档撰写的事实上的规范。 DocBook 是基于SGML/XML的、面向结构的文档撰写模式。它打破了传统的、面向表现的、所见即所得文档撰写模式。 愈早使用 DocBook,愈早获得知识持续积累的快乐,享受完成传世之作的成就感。

(编译自版本: d23f613,最后更新时间: 2011-12-01)


目录

1. DocBook 初体验
1.1. 是否似曾相识
1.2. 文档是这样完成的
2. DocBook 概述
2.1. 为什么使用 DocBook
2.2. 什么是DocBook
2.3. DocBook历史
2.4. 本书的组织
3. Hello World —— DocBook 起步
3.1. 撰写 Hello World
3.2. 搭建编译环境
3.2.1. DocBook DTD
3.2.2. 安装样式表
3.2.3. OpenJade
3.2.4. XSLTPROC
3.3. 编译文档
3.3.1. 准备测试文档——《Hello World》
3.3.2. 用 OpenJade 进行格式转换
3.3.3. 还需进一步完善
4. SGML/XML入门
4.1. 基础概念
4.2. 关于标记语言
4.2.1. 什么是标记语言
4.2.2. 标记语言的历史
4.3. SGML/XML语法基础
4.3.1. 标记
4.3.2. 实体引用
4.3.3. 注释
4.3.4. 处理指令
4.3.5. 文件类型声明
4.3.6. CDATA片段
4.4. 数据模型
4.4.1. 元素
4.4.2. 子元素和属性
4.4.3. 元素的定义
4.4.4. 外部DTD和内部DTD
4.4.5. 其它方式构造数据模型
4.4.6. DocBook的数据模型
4.5. 用样式表进行格式化
4.6. DSSSL
4.6.1. Scheme语言入门
4.7. 格式化
4.7.1. DTD: 我的收藏夹
4.8. 公共标识符、系统标识符和目录文件
4.8.1. 公共标识符、系统标识符
4.8.2. 目录文件:DocBook的粘合剂
4.9. 好形、合法性——DocBook文档遵循的规范
4.10. 元素、实体和属性——DocBook文档的积木
4.11. Why XML?
4.12. SGML和XML的异同
5. 深入 DocBook 文档
5.1. SGML 格式的DocBook文档
5.2. XML 格式的DocBook文档
5.3. DocBook文档的物理分割
5.4. DocBook文档的逻辑分割
5.5. DocBook示例
5.5.1. Book,Chapter,Article
5.5.2. 章节
5.5.3. anchor,link, ulink
5.5.4. 文章头部信息
5.5.5. 列表
5.5.6. 表格
5.5.7. 嵌入图片
5.5.8. Screen, programlist, co
5.5.9. emphsis, phrase, quote, system, filename, ...
5.5.10. faq
5.6. DTD 与 DSSSL
6. DocBook的DTD组织框架和定制
6.1. DTD组织框架
6.2. DTD的定制
7. DocBook的DSSSL组织框架和定制
7.1. DSSSL组织框架
7.2. DSSSL的定制
8. DocBook的XSL组织框架和定制
8.1. XSL组织框架
8.2. XSL的定制
9. 文档的软件工程
9.1. CVS进行版本控制
9.2. 目录结构和Web发布
9.3. Nightly Build
9.3.1. 自动化编译
9.3.2. 计划任务
9.4. 文档检索
10. DocBook在实际中的应用
10.1. 测试用例
10.2. 项目日志
10.3. 版本变更说明
11. 参考