下面是一个符合 sgml 标准的 DocBook 文档——"Hello World!"。虽然它还非常简陋,但是麻雀虽小,五脏俱全。它完全是一个合格的DocBook文档。
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.2//EN"> <article> <articleinfo> <title>Hello World!</title> <author><firstname>名</firstname><surname>姓</surname></author> </articleinfo> <sect1><title>Hello World!</title> <para> Hello world! 这是我的第一个 DocBook 文档。 </para> </sect1> </article>
文档类型声明(Document Type Declaration),声明该文档的根元素是 article。 |
|
文档中的唯一的根元素——article |
|
在此处添上作者的姓名 |
|
第一章开始。根元素article可以包含任意多的sect1元素。 |
|
本文档的根元素结束。 |
即使还没有接触过 DocBook,也不会有人认为以上的 Hello World 文档是一个天书。DocBook 文档是自解释的,通过一个个元素(由尖括号封闭起来的),定义了清晰的文档结构。这片文档是一篇文章(article),它有自己的标题——“Hello World!”,和作者的姓名,它还包含一个章节(sect1),章节的标题是“Hello World!”,内容则是简简单单的一句话。我们把这个文件保存为 helloworld.sgml
。
这就大功告成了么?还没有,我们仅仅完成了 DocBook 文档的撰写。借用程序开发的概念,我们仅仅完成了源代码的编写,还没有生成最终的软件产品(可执行文件)呢,甚至还没有测试过。那么,接下来我们的工作就是先通过安装工具软件来搭建环境,再进行文档的编译,形成所需要的输出格式——HTML、RTF等等。
Copyright © 2006 WorldHello 开放文档之源 计划 |