文档的布局
在本章您将看到 &PROJECT; 文档中,主控文件的示例。这个示例与 Docs Project 处理 DocBook XML 的方式相关。主控文件包含文档的主要结构,以及到定义公共实体的文件的链接,还包括定义文档版本和日期的实体。
主控文件
下面是一个简单的主控文件
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../common/fedora-entities-en.xml">
%FEDORA-ENTITIES-EN;
<!ENTITY VERSION "0.1"> <!-- change version of tutorial here -->
<!ENTITY DOCID "example-tutorial-&VERSION; (2003-07-07)"> <!-- change last modified date here -->
<!ENTITY LEGALNOTICE SYSTEM "../common/legalnotice-en.xml">
]>
<article id="example-tutorial" lang="en">
<articleinfo>
<title>Example Tutorial</title>
<copyright>
<year>2003</year>
<holder>&FORMAL-RHI;</holder>
<holder>Tammy Fox</holder>
</copyright>
<authorgroup>
<author>
<surname>Fox</surname>
<firstname>Tammy</firstname>
</author>
</authorgroup>
&LEGALNOTICE;
</articleinfo>
<section id="some-section">
<title>Some Section</title>
<para>
This is an example section. You can also use sect1, sect2, etc.
</para>
<warning>
<title>Warning</title>
<para>
Example of an admonition.
</para>
</warning>
</section>
<index id="generated-index"></index>
</article>
包含许可信息
文档版式
许可
所有 &PROJECT; 手册 必须 包含文件 legalnotice.xml。这个文件包含了 GNU Free Documentation License (FDL) 的文本。
示例主控文件显示了如何包含它们。