DocBook 文件写作入门.docVIP

精品文档 . DocBook 文件写作入门 作者. 老贡生 Edited by 总编. 老贡生 台湾企鹅宝宝工作队 Revision History Revision 1.2 2004/01/01 15:10:15 ? 第一次正式公开发布 Revision .2.1 2004/01/01 09:25:51 ? 第一次草稿 ? 这是一本帮助以前没接触过 DocBook 格式文件的新手，一个基础导览的技术小手册。本手册并未包含所有 DocBook 标签，及其详细解说。本手册只挑选 DocBook DTD 定义中最常为使用者利用的标签做最基础的解说，尤其会和 HTML 的相类似格式数据做比对。所以不应该希望本手册为你解答所有 DocBook 的疑惑，这只是一个垫脚石和敲门砖，帮助你更快的向 DocBook 的殿堂迈进。 ? ? 本文采用 GNU 组织的 GPL公开版权宣告，欢迎复制,改写,散布，并要求你应该以同样的权利条款，授予文件的使用人。对 GPL 的进一步的解释，请参考 GNU 通用公共许可证。 ? 我的感谢 首先我要感谢 James Clark 先生，没有他，我们就缺少了一个执行 DocBook 文件解析转译的自动执行工具。他的 OpenJade 工具组，是一切 SGML 文件处理的心脏和引擎。由于他的慷慨，使得我们不必花一毛钱，就能拥有商业软件同样的服务和效能。 我们也要感谢 Norman Walsh 先生，要不是他耗费心力制作 docbook-dsssl 转换输出样式表，DocBook 将只是又一个意义分类结构标记语言的实验，一种理论性的教材而已。有了配套的 DSSSL 样式表，DocBook 才能转换成 text,rtf,ps,html 各种文件，真正达成一次输入，多种输出，各种格式文件交换中介的有力工具。 Norman Walsh 先生不只提供 DocBook-DSSSL ，他本身也是 OASIS DocBook 委员会的主要成员。藉由早期的 Davenport 讨论组，到现在 DocBook Committees 参与成员的不断努力，所谓分类意义的结构化文件格式的使用，已经不再只是个目标而已，它已经开始在我们的电子文件处理中日渐担负起重要的使命。 最后，照惯例，要感谢我已七六高龄的老母亲，要不是他打理我生活的一切，我一定连三餐都成问题，还提什么奉献呢？我知道这世间就算没了我们母子，一样阳光灿烂，生气蓬勃，但至少这篇文章是不会问世了。所以如果你觉得从这篇文章多少得到益处，请和我一样，多少感谢我娘及自己的娘一些。 Table of Contents 导论 1. DocBook 是什么 2. DocBook 的源流 3. 开始写作前的准备工作 4. DocBook 编写的注意事项 1. 基础标签的运用 1.1. 无用之用 1.2. 文件型态宣告 1.3. 根标签 1.4. 常用的根标签介绍 1.5. DocBook 最基本的文件结构 -- Sect 1.6. 基本的根卷标结构 1.7. 条列资料表示法 1.8. 表格数据表示法 1.9. 外部其它媒体格式档案表示法 1.10. 书签与联结的表示法 1.11. 其它区块资料的表示法 1.12. 字符串强调表示法 1.13. 其它标签使用方法 2. 特殊数据格式的卷标 2.1. 出版讯息表示法 2.2. 作者序言表示法 2.3. 目录索引表示法 2.4. 词汇解释表示法 2.5. 参考书目表示法 2.6. 问题解答集表示法 2.7. 结语 A. 附录 A.1. 如何查询卷标的组织结构 参考数据 DocBook 参考字典 List of Tables 1. DocBook 文件运作流程表 1-1. mediaobject 主要组成列表 1-2. 特殊意义的区块标签 1-3. DocBook 特殊字符表 A-1. 单纯卷标次序规则叙述表 A-2. 综合卷标次序规则叙述表 List of Figures 1-1. DocBook DTD 文件组成结构图 List of Examples 1-1. SGML 的备注表示法 1-2. SGML 的文件型态宣告 1-3. XML 的文件型态宣告 1-4. sect 的基本结构 1-5. sect 的层级结构 1-6. chapter 基本的层级结构 1-7. book 基本的层级结构 1-8. book 的 SGML 文件模型 1-