跳转至内容

帮助:有效使用标题

来自 ArchWiki

本文旨在协助 Wiki 作者和编辑创建有效的文章,并提升 ArchWiki 读者的阅读体验。

您无需了解如何编辑 Wiki 页面即可参考本文。本页是一份较为通用的风格指南,而非技术编辑指南

关于文章标题

标题标志着一个新章节的开始。章节可以组织成树状结构,某些章节嵌套在其他章节之中。为了反映章节结构,标题可以采用不同的格式。根据相对于其他章节的位置,章节及其对应的标题被分为不同的层级。

本文使用的术语

一个被包含在另一个章节中的章节被认为比其容器(或父级)的层级较低。因此,父级的层级较高

每个标题及其延伸至下一个同级标题之间的文本被统称为一个层级标题 (heading)

层级标题拥有描述其在树状结构中位置的数字层级越高,数字越小,反之亦然。例如,ArchWiki 的文章标题是1 级标题。

标题和层级标题的使用

标题和层级标题具有几个重要用途:

  • 它们能减缓读者的阅读速度,以便更好地吸收信息
  • 它们将文章的部分内容划分为逻辑单元
  • 它们标记重要的文本片段

减缓读者的阅读速度

在向读者展示您的主题时,必须意识到即使是最短的文章也需要一定的阅读时间。标题可以作为一个缓冲区,在读者阅读接下来的章节之前减缓其速度。这种减速允许读者思考内容,并为接下来的文本做好准备。

将段落分组为子主题

大多数情况下,您的文章不会只讨论一个主题,您需要触及一些相关程度不一的主题,以解释和扩展您的主旨。当读者尝试快速浏览文章时,这种跳转可能会令人困惑。因此,您需要为这类偏差提供信号。

标记重要部分

有时,读者只想浏览目录 (TOC) 以识别文章中他们特别感兴趣的部分。他们也可能通过直接查看标题来这样做。在这两种情况下,定义清晰的标题都有助于快速识别文章的重要章节。此外,目录是通过自动列出文章中的层级标题而创建的。

关于标题层级

谈到标题层级时,有几点重要事项需要注意。

相同层级的标题应具有同等的重要性

这听起来像是显而易见的事,但实际上并不像看起来那么简单。请考虑这个例子:

  • 简介
  • 步骤 1:安装 X
  • 步骤 2:编辑键盘设置
  • 步骤 3:编辑鼠标设置
  • 步骤 4:编辑显示设置
  • 步骤 5:添加 fglrx 选项
  • 步骤 6:启动 X
  • 结论

如果您仔细分析这个列表,会发现步骤 2 到 4 的重要性实际上低于步骤 1 和 6,而步骤 5 的重要性最低。这并不是说这些步骤的文本量多少的问题,而是概念上的重要性。

为了修正这一点,我们将这样修改标题:

  • 简介
  • 步骤 1:安装 X
  • 步骤 2:配置 X
    • 步骤 2a:编辑键盘设置
    • 步骤 2b:编辑鼠标设置
    • 步骤 2c:编辑显示设置
      • 步骤 2c-1:添加 fglrx 选项
  • 步骤 3:启动 X
  • 结论

如您所见,我们将步骤 2 到 4 合并为一个名为“配置 X”的单一标题,并将该标题分为 3 个子标题。同时,我们将步骤 5 附加到步骤 2c 之下,将其变为一个子标题。

顶层标题应始终处于最高层级

这听起来可能也是常识,但有一个小问题。标题关联着格式样式。许多人利用这些关联的格式规则来操纵文章的外观,这反过来导致了标题结构的损坏。

让我们看看这个例子:

  • 简介
  • 步骤 1
  • 步骤 2
  • 步骤 3
    • 结语

文章作者认为 1 级标题对于像“结语”这样不重要的章节来说太大了,使用 2 级标题会更好。这导致标题结构中最后一个章节比其他章节低一个层级。正确的结构应该是:

  • 简介
  • 步骤 1
  • 步骤 2
  • 步骤 3
  • 结语

现在的结语与文章的其他部分保持一致。

注意“引言”“结语”这样的章节被赋予与正文相同的重要性可能看起来有些奇怪,但这些章节实际上非常重要。与其为了美观而将其降级为低级标题并破坏文章的逻辑结构,不如在文章末尾添加一个注释(就像这个一样),或者完全删除表述不佳或内容缺失的章节。

标题结构类型

根据使用的层级数量及其目的,标题结构可分为以下几类:

  1. 单层结构
  2. 伪多层结构
  3. 多层结构

单层结构

在撰写文章时,最直接的方法是将其分为若干步骤。这些步骤不一定是读者需要执行的实际步骤,也可能是作者在构思文章时的步骤。无论如何,这些步骤依次排列,构成单层结构。

这类典型的设置可能如下所示:

  • 简介
  • 步骤 1:执行此项或彼项
  • 步骤 2:清理工作
  • 步骤 3:故障排除
  • 进一步阅读

这就是一个带有引言和参考文献的简单 3 步页面的样子。

伪多层结构

有时,需要偏离这种简单流畅的单层结构。

侧注

通常,您需要短时间地偏离主线以详细阐述某事。

  • 简介
  • 步骤 1:执行此项或彼项
    • 关于配置 XYZ 的说明
  • 步骤 2:清理工作
  • 步骤 3:故障排除
  • 进一步阅读

可以将此视为使用Note 模板添加笔记和评论的替代方案。

标记辅助信息

也许您想为某个重要部分添加标记,使其作为主讨论的补充论据,或以其他方式增强主讨论。

  • 简介
  • 步骤 1:执行此项或彼项
    • 以下是示例代码
  • 步骤 2:清理工作
    • 以下是示例代码
  • 步骤 3:故障排除
    • 以下是示例代码
  • 进一步阅读

多层结构

多层结构是较长、较深入的文章的典型特征。然而,它也可以有效地用于较短的页面。

以下是一些多层结构会派上用场的场景。

注意 请记住,我们描述的是标题层级的父子关系,无论父级是 1 级、2 级还是 3 级并不重要。这同样适用于所有具有 2 个或更多层级的多层结构。

将论据分组

子标题之于主标题,正如标题之于整篇文章。

一个例子:

  • 简介
  • 步骤 1:执行此项或彼项
  • 步骤 2:清理工作
    • 首先这样做
    • 然后那样做
    • 完成!
  • 步骤 3:故障排除
  • 进一步阅读

替代方案/论据

有时,您需要给读者提供看待某个主题的几种不同角度。

例如:

  • 简介
  • 步骤 1:执行此项或彼项
    • 这是方法一
    • 这是方法二
  • 步骤 2:清理工作
  • 步骤 3:故障排除
  • 进一步阅读

矛盾论据

如果您需要讨论相反的观点,可以为每个阵营提供一个独立的子标题。

例如:

  • 简介
  • 步骤 1:执行此项或彼项
    • 您想要这个
    • 然而,有理由不想要这个
  • 步骤 2:清理工作
  • 步骤 3:故障排除
  • 进一步阅读

标题文本

我们在这里总结一些关键点,如果您需要更详细的说明,可以阅读帮助:文章命名指南。此处列出的规则同时适用于标题文本和文章名称。

  • 标题文本应尽可能具体,并应反映标题的范围
  • 标题文本应足够通用,以便于未来对标题进行增强
  • 标题文本应尽可能短(另见帮助:文章命名指南

格式化

正如我们已经指出的,不要滥用标题格式样式来美化文章至关重要。如果您不喜欢所看到的效果,请联系管理员或系统管理员征询他们的意见,或提出在不损害标题结构的前提下修复方案。

要将某些文本标记为标题,必须使用两个或更多等号(==)。

注意 支持的最低标题层级实际上是 1 (=),但其格式是保留给文章标题的:文章章节必须始终从 2 级开始。

以下是标记标题的代码

== Header level 2 ==

=== Header level 3 ===

==== Header level 4 ====

===== Header level 5 =====

====== Header level 6 ======

如果您想查看这些是如何格式化的,可以使用沙盒 (Sandbox)。相关风格约定请参阅帮助:风格#章节标题

© . This site is unofficial and not affiliated with Arch Linux.

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.