3. 一个极简文档

在本节中，您将找到符合 linuxdoc dtd 规范的极简文档所需的内容。它旨在提供初步了解。如果您已经了解这些原则，请跳过本节。

3.1 逐步进行

创建美观的 linuxdoc 文档并将其映射到您需要的形式，您必须执行以下步骤：

• 选择一个纯文本编辑器。
• 创建一个文件并命名它（或稍后将其另存为），例如 start.sgml。
• 键入文档
• 保存文件并关闭编辑器。
• 通过键入 sgmlcheck start.sgml 运行检查器。
• 如果报告了错误，请在编辑器中重新打开文档并尝试更正它

  sgmlcheck 的错误消息将为您提供有关错误类型以及错误发生的行和列的提示。

  。 再次运行检查器，直到不再出现错误。
• 现在您必须决定您的文档的用途。选择适当的解析器映射器组合并转换您的文档。 要查找 SGML-Tools 中可用的映射器，请参见表 sgml 文档的 SGML-Tools 映射器。

  sgml 文档的 SGML-Tools 映射器

  输入	以产生
  sgml2html start.sgml	用于 Web 浏览器的超文本标记语言
  sgml2lyx start.sgml	Lyx 或 KLyx 所见即所得文本格式
  sgml2info start.sgml	用于 UN*X info 的 Info 页面
  sgml2latex start.sgml	DVI 输出
  sgml2latex --output=tex start.sgml	纯 tex 输出
  sgml2latex --output=ps start.sgml	postscript 输出
  sgml2rtf start.sgml	富文本格式
  sgml2txt start.sgml	纯文本

3.2 启动文档

我们从一个简单的文档开始（行首的数字和冒号用于解释，请勿输入！）

1: <!doctype linuxdoc system>
2: <notes>
3: <title>A Small Linuxdoc Example</title>
4: <p>Hello <em>world</em>.</p>
5: <p><bf>Here</bf> we are.</p>
6: </notes>

现在我们来看看单行

1. 像所有符合 SGML 规范的文档一样，linuxdoc 文档必须以序言开头。 如果您愿意，您可以将其视为必要的魔法，或者您可以尝试查找有关 SGML 的更多信息。 序言指示 SGML 解析器应该使用哪个 dtd（文档类型定义）来检查文档的语法。
2. 打开文档类：您必须决定要编写哪种类型的文档。 有关文档类的详细描述，请参见 文档类 部分。 还将在那里解释必要的标头信息，这些信息取决于文档类。 在我们的例子中，我们放置一个 <notes> 标签，形成一个注释，指示一个简单的非结构化文档。
3. 即使是可选的，为文档提供标题也是一个好主意。 这是通过 <title> 标签完成的。
4. 由 <p> 标签标记的段落，包含单词 world，该单词通过 <em> 标签进行行内强调。
5. 另一个完全标记的段落，另一个单词通过 <bf> 标签进行行内粗体。
6. 这里我们关闭打开的文档类标签。

相同的示例可以写得更短一些，方法是省略解析器自动放置的标签，并使用缩短的标签

1: <!doctype linuxdoc system>
2: <notes>
3: <title>A Small Linuxdoc Example
4: <p>Hello <em/world/.
5:
6: <bf/Here/ we are.
7: </notes>

现在我们再次查看单行

1. 序言。
2. 文档类（也未更改）。
3. 标题。 它没有关闭，因为下一行中的 p 标签隐式地关闭了它。
4. 段落隐式地关闭了标题。 强调标签以简短形式表示。 只有当您的标记文本不包含文字 / 时，才能使用简短表示法。 段落在此行中未显式关闭。
5. 此处的空行是您不需要关闭上一个段落且不需要打开下一个段落的原因。 空行被解释为当前段落的结尾和新段落的开始。
6. 另一个段落（未直接打开），带有另一个简短的行内标签。
7. 关闭打开的文档类标签，该标签也隐式地关闭了仍然打开的段落。

也许现在更清楚了，您必须如何使用标签。