普通文本(本文中称为“内嵌文本”inline
text)可以包含一个特殊格式和交叉引用元素。内嵌文本可以出现在章节,附录和节的标题,以及版权声明,段落内部等地方。
DebianDoc SGML中定义了一些特殊元素来描述特别重要的文字。如果使用了特殊字符标记,要记得所有的特征标记必需有配对的结束标记,即必须明确的用<element>,或者用简略方式/表示内嵌元素的结束(参见SGML标记和元字符, 章 1)。
通常,用斜体字或者粗体字或者带下划线字来表示强调的文字。在纯文本格式中,一般在包含的文字两边加“*”表示,例如*this*。
通常用粗体字表示。在纯文本格式中,一般在包含的文字两边加“*”表示,例如*this*。
语法名词通常用斜体字显示。在纯文本格式中,用尖括号包围文字,就象<this>。如果几个语法名词连在一起出现,每个都会如此显示。
通常用固定宽度文字显示;在纯文本格式中,可能用引号括起包名。
这通常用固定宽度文字显示。在纯文本格式中则不作特殊处理。
这通常用固定宽度文字显示。在纯文本格式中,通常用引号括起路径名。
这通常用固定宽度文字显示。在纯文本格式中,通常用引号括起路径名。
In formats where cross-references can be made non-intrusively by making a region of text a hyperlink without introducing in-line text this element will cause its contained text to become a hyperlink to the target of the cross-reference. In other formats this element will not have any effect.
交叉引用是引用本文档或者其他文档的某一部分的元素。
同一文件内的交叉引用是基于引用id的。每一章节,附录,节或者子节都可以有一个id属性,这个id属性可以作为被引用的依据。例如,<chapt id="spong">表示这个章节有一个id属性spong。这个引用id可以在文中的其他部分用特别的交叉引用元素来引用。
引用标识符也将用于在HTML文档中产生正确的文件名和引用名。如果没有定义引用id,则使用章节和附录等的章节号。每一章和每一节和每一个附录都定义一个引用id是一个好主意,这样,交叉引用中显示的文件名不会因为章节的次序而改变。
标记<ref>本身没有任何内容;章节、附录的序号和页码等将自动插入到标记的位置。
交叉引用通常是个名词,适合象下面的场合:(参见 <ref id="...">) 或者 更详细的说明在 <ref id="...">..
在一些格式中,这将产生真正的交叉引用,例如电子邮件地址的链接。另外一些格式中,经常只是用尖括号括起来而已。
这两个元素通常用固定宽度字符显示。如果可能,<ftppath>将表示为一个<ftpsite>上的一个路径的超级链接。
在一个章节或者附录中,<ftppath>的定义必须在<ftpsite>之后。但是,一旦定义了一个站点,则可以定义该站点的几个路径。
这两个元素通常用固定宽度字符显示。如果可能,<httppath>将表示为一个<httpsite>上的一个路径的超级链接。
在一个章节或者附录中,<httppath>的定义必须在<httpsite>之后。但是,一旦定义了一个站点,则可以定义该站点的几个路径。
通常这个元素用固定宽度文字显示;如果可能,name将作为id的超级链接显示。
脚注可以用于文档的大多数位置,用如下的元素表示:<footnote>...</footnote>。脚注内的文字不会显示在指定的位置,而是代之以一个交叉引用或者超级链接,真正的内容将根据格式的不同放到不同的位置。
脚注的内容可以是一个或者多个段落。第一个段落不必用<p>标记出来。值得注意的是,脚注内的文字不能使用其他的修饰元素。
脚注也可以嵌套,但这应该尽量避免。
ardo@debian.org
ijackson@gnu.ai.mit.edu
linuxman@sd163.net