5. 它是如何工作的?

我们尝试使用与维基百科上相同的文本提示,这些提示来自 UseModWiki。不同的 Wiki 系统之间存在一些差异,但它们中的大多数与此系统非常相似,并且已在实践中证明了自身的价值。

空行分隔段落,还有其他提示用于创建章节、项目符号列表、链接、文件名等。

5.1. 章节

=Introduction|intro=

创建一个新的顶级章节。 看到管道符后跟 "intro" 了吗? 许多提示都提供了 "id",这就是您提供它的方式。 对于章节,id 将成为输出文件名(在第一个示例中为 intro.html),或者用于文档内链接的 html "标签"。

==How Does It Work?|how-does-it-work==

创建一个二级章节,以及

===Why Would I Use It?|why?===

创建一个三级章节。

5.2. 列表

5.2.1. 编号列表

#one
#two
#three
/#

“#” 前缀表示创建编号列表。 编号列表会持续到当前章节结束,或者直到遇到仅包含 “/#” 的行,这将关闭列表。 在打开另一个 “#” 列表后,编号将从 “1” 重新开始。

以下是上述代码块在最终文档中的显示方式

5.2.2. 项目符号列表

项目符号列表的工作方式几乎相同,除了您使用 “*” 提示,并且您不必担心重新编号的问题

*one
*two
*three
/*

以下是上述代码块在最终文档中的显示方式

5.3. 链接

使用方括号来标识链接,像这样

[[http://www.linuxdoc.org|Linux Documentation Project]]

在这种情况下,管道符后的文本不是 id,而是链接的 “标题”。

除了您可能熟悉的标准 “http:” 和 “mailto:” 命名空间之外,您还可以使用两个特殊的命名空间。 第一个是 “ldp:” 命名空间。 查看以下链接

[[ldp:Distributions-HOWTO]]

当您使用 “ldp:” 命名空间时,WikiText 将在 LDP 数据库中查找您命名的文档,并生成指向它的链接。

注意:我们仍在努力在所有数据库记录中输入正确的 “name”,因此只有少数几个可以正常工作。 但是请不要担心。 如果您需要使用尚未正确的链接,请告诉我们,我们会立即修复它。

第二个特殊的命名空间是 “wiki:” 命名空间。 它将生成指向维基百科上文章的链接,维基百科是一个开源百科全书项目。 我们希望在 LDP 上镜像维基百科上一些最合适的文章。 维基百科有很多关于计算机相关主题的优秀文章,这些文章不是我们在 LDP 所做的那种信息,但可以很好地补充我们的文档。 例如,有关于虚拟内存、操作系统等的文章。 目前,您的链接将转到实时的维基百科站点。 最终,它将转到我们站点上的镜像,但会链接到 “真实” 站点。

以下链接指向维基百科上名为 “Operating system” 和 “Linux kernel” 的文章

[[wiki:Operating system]]
[[wiki:Linux kernel]]

维基百科是所有网民的绝佳资源。 他们使用的软件和内容都是开源的。

5.4. 文件名

您可以使用双括号将文件名括起来来指示文件名,就像 http 和其他链接一样。 或者,您可以指定 “file” 命名空间

[[/etc/apache/httpd.conf]]
[[file:/etc/apache/httpd.conf]]

无论哪种方式,它都将呈现为/etc/apache/httpd.conf.

5.5. 强调

您可以通过用三个 (3) 单引号将某些单词括起来来强调它们,像这样

'''Wow!'''

那将呈现为: Wow!

5.6. 问答集

如果您正在编写 FAQ,或者您的文档中有 FAQ 章节,则可以创建问答集。 只需使 “Q:” 和 “A:” 成为新行的第一个字符,QandASet 标签将自动创建。

Q: What if you want to do DocBook that isn't supported by WikiText?

A: Mu.

这就是示例的呈现方式。 请注意,在第一个问题之前立即出现问题列表。 在此示例中,这看起来有点傻,因为只有一个问题,并且它只是重复了两次。 但是,如果您正在处理 Linux-FAQ,那就非常好了。

Q: 如果您想使用 WikiText 不支持的 DocBook,该怎么办?

Q: 如果您想使用 WikiText 不支持的 DocBook,该怎么办?

A: Mu。 请参阅下一节。

5.7. 高级功能

没有 WikiText 不支持的 DocBook 结构。 为什么? 因为如果没有适用于它的 WikiText,您可以直接将所需的标签放入文档中,它们就可以工作。

有一些 “特殊” 标签不是内联 DocBook,而是章节结构,其中包括 “programlisting” 和 “screen” 标签。 您应该记住,WikiText 的任何功能都无法在这些标签内工作。 您不希望代码示例中的注释行转换为编号列表,对吗?

# this is a comment
# it is NOT a numbered list!