随便译译 - DocBook 权威指南

现在不大可能翻译得完，先把这一点点贴出来。

DocBook 权威指南 2.0.9 (Alpha)

by Norman Walsh and Leonard Muellner

Updated: Wed, 31 Dec 2003

试翻译稿

译 / Jjgod Jiang
更新于 Mon, 29 Mar 2004
更新于 Wed, 21 Jul 2004

Preface
前言

$Revision: 1.0 $

$Date: 2004/03/29 15:53:30 $

DocBook 提供了一个使用 SGML 或 XML 来书写结构化文档的系统。虽说从没有什么限制，但它特别适合于那些关于计算机软硬件的书籍和文献。DocBook 是一个文档类型定义 (document type definition (DTD))。由于这种 DTD 的强大与健壮，也由于它的主体结构与撰写书籍的大众观点如此契合，DocBook 得到大量作者的采用，而且这个群体还在增长着。多少出乎意料地，DocBook 还被许多商业工具支持。同时，自由软件 (free software) 环境中对此的支持也在迅速成长着。简而言之，DocBook 是一个易于理解而广泛应用的 DTD。在世界的每个角落，成千的组织使用 DocBook 来撰写过百万页的，各种印刷或在线格式的，文档。

为何阅读此书？

这本书被设定为一本清晰、简明、标准的 DocBook DTD 参考。这本书也是 DocBook DTD 的官方文档。

一句话，我们希望回答你所有关于 DocBook 中的元素 (elements) 和实体 (entities) 的问题。特别地，我们包含了如下主题：

• DocBook 的常用环境。DocBook 可能在一开始不大好接受，因为它有超过 300 种元素。我们将很快地让你了解这些部分是如何组合在一起的。
• 如何撰写 DocBook 文档。从何处开始及怎么做。
• 解析与验证。当你写好了一个文档，怎样知道它是否符合 DocBook DTD 相符呢？
• 如何发布(publish) DocBook 文档。写好以后怎么处理它？我们提供了一个使用一些常用免费工具进行 DocBook 文档发布的指南，让你把它们以印刷或者网页形式发布出来。
• 自定义 DTD。许多个人和公司都定义了自己的 DocBook DTD 标准。无论你的主题与计算机软件相关与否，都可以按照我们的解释来裁剪 DocBook，使之适合你要表达的信息。
• 理解所有的元素。每个元素都仔细地文档化了，包括其期望的语义和提供给它的每个属性的目的。每个元素都提供了一个正确运用它的例子。还描述了那些参数实体(parameter entity)和字符实体(character entity)。
• 样式表。简单论述了一些标准的样式表语言。
• XML 兼容性。你或你的组织如果要使用 XML 进行撰写或发布，我们为你勾勒了所有需要关注的要点。
• 额外资源和一张 CD-ROM。最后，我们将告诉你哪里能找到最新信息，并在 CD-ROM 中提供了一份完整地在线文档。

(未完待续)