3.1. 撰写 Hello World

下面是一个符合 sgml 标准的 DocBook 文档——"Hello World!"。虽然它还非常简陋,但是麻雀虽小,五脏俱全。它完全是一个合格的DocBook文档。

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.2//EN">	1
<article>		2
<articleinfo>
  <title>Hello World!</title>
  <author><firstname>名</firstname><surname>姓</surname></author> 3
</articleinfo>

<sect1><title>Hello World!</title>	4
  <para>
  Hello world! 这是我的第一个 DocBook 文档。
  </para>
</sect1>
</article>	5
1

文档类型声明(Document Type Declaration),声明该文档的根元素是 article。

2

文档中的唯一的根元素——article

3

在此处添上作者的姓名

4

第一章开始。根元素article可以包含任意多的sect1元素。

5

本文档的根元素结束。

即使还没有接触过 DocBook,也不会有人认为以上的 Hello World 文档是一个天书。DocBook 文档是自解释的,通过一个个元素(由尖括号封闭起来的),定义了清晰的文档结构。这片文档是一篇文章(article),它有自己的标题——“Hello World!”,和作者的姓名,它还包含一个章节(sect1),章节的标题是“Hello World!”,内容则是简简单单的一句话。我们把这个文件保存为 helloworld.sgml

这就大功告成了么?还没有,我们仅仅完成了 DocBook 文档的撰写。借用程序开发的概念,我们仅仅完成了源代码的编写,还没有生成最终的软件产品(可执行文件)呢,甚至还没有测试过。那么,接下来我们的工作就是先通过安装工具软件来搭建环境,再进行文档的编译,形成所需要的输出格式——HTML、RTF等等。