3 用户指南 DTD

3.1 part DTD

The part DTD 用于 "正常" 文档，例如用户指南或发行说明。首先是一些介绍主要内容的段落。之后是章节，它们使用 chapter DTD 在单独的文件中编写。

示例

<?xml version="1.0" encoding="latin1" ?>
<!DOCTYPE part SYSTEM "part.dtd">
<part>
  <header>
    <title>The chapter title</title>
    <prepared>The author</prepared>
    <docno/>
    <date/>
    <rev/>
  </header>

  <description>
    <p>Some text..</p>
  </description>

  <include file="file1"></include>
  <include file="file2"></include>
</part>

3.2 <part>

part DTD 的顶层标签。

包含一个 <header>，一个可选的 <description>，后面跟着一个或多个 <include>.

3.3 <description>

标题后的介绍，位于主体章节/手册页之前。

包含任何组合和任何数量的 block tags，除了 <image> 和 <table>.

3.4 <include>

一个空标签。属性 file 指定要包含的文件。应省略 .xml 文件扩展名。

示例

<include file="notes"></include>

3.5 chapter DTD

The chapter DTD 用于用户指南或类似文档中的章节，其文本被分成可以嵌套的节。

示例

<?xml version="1.0" encoding="latin1" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">
<chapter>
  <header>
    <title>Title on first level</title>
    <prepared/>
    <docno/>
    <date/>
    <rev/>
  </header>
  
  <p>Introduction...</p>

  <section>
    <title>Title on second level</title>

    <p>First paragraph.</p>

    <p>Second paragraph etc.</p>

    <section>
      <title>Title on third level</title>

      <p>...</p>
    </section>
  </section>

  ...
</chapter>

3.6 <chapter>

chapter DTD 的顶层标签。

包含一个 <header>，一个可选的介绍，包含任何组合的 block tags，后面跟着一个或多个 <section>.

3.7 <section>

章节的细分。

包含一个可选的 <marker>，一个 <title>，后面跟着任何组合和任何数量的 block tags 和 <section ghlink="maint/lib/erl_docgen/doc/src/user_guide_dtds.xml#L172">.

3.8 <title>

节标题，包含纯文本。