[ 上一页 ] [ 版权声明 ] [ 目录 ] [ 下一页 ]

DebianDoc-SGML 手册
章 2 整体结构


文件的第一行应该是

     <!doctype debiandoc public "-//DebianDoc//DTD DebianDoc//EN">

或者

     <!doctype debiandoc system>

用来说明该文档是Debiandoc-SGML文件。

文件须以 <book>标记开始,并以</book>标记结束。

然后应该是<title>,一个或者多个 <author> (每个作者包含<name>和可选的<email>), 可选的 <version>. 上面的每一项都是一段标记了的inline text - 参见 标记文本和特殊字符标记, 章 4. <version> 也可以包括 <date> 用来表示文档的形成日期。

接着可以是一个 <abstract>, <copyright>, 和 <toc>

<abstract> 为一简单的单一段落。

<copyright>包含一个或者多个版权声明,可以为多个段落 ,其中第一个段落必须使用 <p>以和其他段落区别开来。

<toc>标记说明,此处将显示文章的目录。<toc> 本身并没有包含任何内容 - 其内容是由处理系统产生的。<toc> 可以附带一个属性来说明产生的目录的详尽程度,比如, <toc sect1>说明目录中应该包括子章节,而<toc chapt>说明,目录中只能包括章节和附录。合法的属性值为 chapt, sect, sect1 and sect2.

接下来是文档的主体 — 一个或者多个章节<chapt>,其后可以是一个或者多个附录<appendix>

对于下列元素,<title>, <author>, <version>, <abstract><copyright>可以省略结束标记 - 下一个标记的开始隐含了上一个标记的结束。


[ 上一页 ] [ 版权声明 ] [ 目录 ] [ 下一页 ]
DebianDoc-SGML 手册
14 二月 2002
Ardo van Rangelrooij ardo@debian.org
Ian Jackson ijackson@gnu.ai.mit.edu
宿宝臣(翻译) linuxman@sd163.net