跳转至内容

帮助:编辑

来自 ArchWiki

相关文章

这是一篇关于编辑 ArchWiki 的指南。

注
  • 在编辑或创建页面之前，建议用户先熟悉现有条目的通用语气、布局和风格。
  • 应努力在整个维基中保持一致性。请参阅 ArchWiki:Contributing、Help:Reading 和 Help:Style 以了解通用规范。
  • 若要练习编辑，请使用 沙盒。关于维基标记的概述，请参阅 Help:Cheatsheet。

ArchWiki 由 MediaWiki 提供支持，这是一款使用 PHP 编写的自由软件 维基 软件包，最初为 Wikipedia 设计。更深入的帮助请参考 MediaWiki 的 帮助目录 和维基百科的 帮助目录。

创建账号

注册前，请先熟悉我们的 行为准则。要编辑 ArchWiki 条目，您必须 创建一个 ArchWiki 账户 并确认注册时使用的电子邮箱。回答验证码问题需要一个更新的 Arch Linux 环境：非常欢迎非 Arch 用户为维基做贡献，为了回答该问题，他们可以启动到一个带有 最新安装镜像 的 Arch Live 系统，使用 pacman-staticAUR（提供预编译二进制文件），或者简单地使用利用 Docker 等工具的容器镜像。

拥有账户后，请从 Special:UserLogin 登录。

注意 通过 accounts.archlinux.org 实现的 单点登录 尚未实现。请参阅 archlinux/infrastructure#38。

编辑

要开始编辑页面，请点击页面顶部的“编辑源代码”标签。或者，用户可以通过点击章节标题右侧的“编辑源代码”链接来编辑条目的特定章节。系统将显示“编辑 页面名称”或“编辑 页面名称 (章节)”页面，其中包含以下元素：

  • 编辑工具栏（可选）
  • 编辑框
  • 编辑摘要框
  • “保存更改”或“保存页面”、“显示预览”、“显示差异”和“取消”链接

编辑框将包含当前页面或章节修订版本的 维基文本（服务器据此生成网页的可编辑源代码）。要执行编辑：

  1. 根据需要修改维基文本（详情请见下文 #格式化）。
  2. 在 摘要 框中说明编辑内容（例如“修正错别字”或“添加了关于 xyz 的信息”）。
    注意 所有编辑都应附带描述性摘要，以方便其他用户审核。更多信息请参阅 ArchWiki:Contributing#The 3 fundamental rules。
  3. 使用“显示预览”按钮可以在保存前进行校对并验证格式。
  4. 如果编辑是表面性的且无可争议的，请勾选“这是一次小编辑”复选框，将其标记为 小编辑。
  5. 点击“保存更改”以保存。如果不满意，请点击“取消”（或重复上述过程直到满意为止）。
注意 条目不应署名，因为它们是共同作品；不应将某个编辑者从其他人中突出显示。

撤销编辑

如果页面被错误地编辑，以下程序描述了如何将条目恢复到之前的版本。要撤销单次编辑：

  1. 点击待修改页面顶部的“查看历史”标签（在“编辑源代码”标签旁）。系统会显示修订版本列表。
  2. 点击不需要的编辑右侧的“撤销”链接。系统将显示一个编辑预览，左侧为当前版本，右侧为待保存的文本。
  3. 在编辑摘要字段中填写撤销此次编辑的原因。
  4. 如果满意，点击页面底部的“保存更改”按钮。

维基页面现在应该已恢复到其原始状态。

有时需要一次性撤销最近的多次编辑。要将条目恢复到之前的版本：

  1. 点击待修改页面顶部的“查看历史”标签（在“编辑源代码”标签旁）。系统会显示修订版本列表。
  2. 通过点击相应的时间戳查看所需的修订版本（即最后一个“良好”版本）。系统将显示该修订版本。
  3. 点击页面顶部的“编辑源代码”标签。系统将显示警告：“您正在编辑本页面的过期版本”。
  4. 在编辑摘要字段中写入修订版本时间戳（显示在页面顶部）以及撤销页面状态的原因。
  5. 如果满意，直接点击“保存更改”按钮以恢复到该版本。
注
  • 避免将撤销和编辑合并在一起。先撤销编辑，然后再进行额外修改；不要直接在修订预览中进行编辑。
  • 在执行撤销操作时，请考虑使用特别详细和冗长的编辑摘要，以防止冗长的讨论。

创建页面

在创建新页面之前，请考虑以下事项：

  • 您的主题与 Arch Linux 相关吗？无关或无用的条目将被删除。
  • 您的主题对他人的兴趣有价值吗？不仅要考虑您想写的内容，还要考虑他人可能想阅读的内容。个人笔记应放在您的用户页面中。
  • 您的主题是否值得创建一个新页面？在维基中搜索类似的条目。如果存在，请考虑改进现有条目或在现有条目中添加章节。
  • 您的贡献是否具有重要意义？除非计划在短期内扩充，否则请避免创建存根。

创建新页面需要选择一个描述性的标题和适当的分类。

请阅读 Help:Article naming guidelines 和 Help:Style#Title 以获取条目命名建议。页面标题中不要包含“Arch Linux”或其变体。这是 Arch Linux 维基，默认条目将与 Arch Linux 相关（例如，“Installing Openbox”；而不是“Installing Openbox in Arch Linux”）。

访问 目录 以帮助选择合适的分类。条目可以属于多个分类，只要一个分类不是另一个分类的父级即可（请参阅 Help:Style#Categories）。

要将新页面添加到某个分类（例如“我的新页面”到“某个分类”），您需要：

  1. 通过浏览 https://wiki.archlinux.org.cn/title/My_new_page 创建带有新标题的页面（记得将“My_new_page”替换为预期的标题！）
  2. 在页面顶部添加 [[Category:某个分类]]
注意 不要创建未分类的页面。所有页面必须至少属于一个分类。如果您找不到合适的分类，请考虑创建一个新分类。

在这一阶段，新条目仍被视为 孤立页面。为了完成工作，请多花一点时间从其他页面链接到该新条目：这将提高其可见性并鼓励更多用户参与贡献。可能的候选条目包括相关软件的条目、更通用的概览页面，甚至是简单的列表，如 List of applications。

在某些情况下，创建一个子页面（即另一个页面的子级）可能更合理：子页面标题通过“/”符号（斜杠）与父页面标题分隔。这在自己的用户页面下准备草稿时非常有用，例如 https://wiki.archlinux.org.cn/title/User:Myself/My_new_subpage。

格式化

文本格式化尽可能使用维基标记完成；无需学习 HTML。常见的格式化任务也可使用各种模板；有关模板的信息，请参阅 Help:Template。Help:Cheatsheet 总结了最常用的格式化选项。

标题和子标题

标题和子标题是改进条目结构的简单方法。如果您能看到正在讨论的独特主题，可以通过为每个章节插入标题来拆分条目。有关风格信息，请参阅 Help:Style#Section headings 和 Help:Effective use of headers。

标题必须从二级开始，可以这样创建：

== Second-level heading ==

=== Third-level heading ===

==== Fourth-level heading ====

===== Fifth-level heading =====

====== Sixth-level heading ======
注意 不允许使用一级标题，其格式保留给条目标题。

如果条目至少有四个标题，则会自动生成目录 (TOC)。如果不需要，请在条目中放置 __NOTOC__。尝试在 沙盒 中创建一些标题，看看对目录的影响。

换行

空行用于开始新段落，而单个换行符在常规段落中无效。

HTML <br> 标签可用于手动插入换行，但应避免使用。手动换行可能在其他格式元素（如列表）中是合理的。

维基文本 渲染效果
This sentence
is broken into
three lines.

这句话被分成三行。

This is paragraph number one.

This is paragraph number two.

这是第一段。

这是第二段。

* This point <br> spans multiple lines
* This point
ends the list
  • 该要点
    跨越多行
  • 该要点

结束列表

有关正确使用空白字符的信息，请参阅 Help:Style/White space。

粗体和斜体

粗体 和 斜体 是通过用两个、三个或五个撇号 (') 包围单词或短语来添加的

维基文本 渲染效果

''斜体''

斜体

'''粗体'''

加粗

'''''粗体和斜体'''''

加粗且斜体

删除线

使用删除线文本表示该文本不再适用或不再相关。

维基文本 渲染效果
<s>Strike-out text</s>

删除线文本

列表

请记住，维基语法不支持多行列表项；每个换行符都会结束列表项定义。要在列表项内开始新行，请使用 <br> 标签。要在列表项内输入多行代码块，请使用 Template:bc 并使用 <nowiki> 标签转义内容。另请参阅 Help:Style/White space 和 Help:Template。

无序列表

无序列表的项目没有明显的顺序。

要插入无序列表，请使用星号 (*)。多个 * 将增加缩进级别。

维基文本 渲染效果
* First item
* Second item
** Sub-item
* Third item
  • 第一项
  • 第二项
    • 子项
  • 第三项

有序列表

有序列表引入编号，从而对列表项进行排序。只要项目出现的顺序不是主要考虑因素，通常应使用无序列表。

要创建有序列表，请使用数字符号或井号 (#)。多个 # 将增加缩进级别。

维基文本 渲染效果
# First item
# Second item
## Sub-item
# Third item
  1. 第一项
  2. 第二项
    1. 子项
  3. 第三项
# First item
# Second item
#* Sub-item
# Third item
  1. 第一项
  2. 第二项
    • 子项
  3. 第三项

定义列表

定义（又称 描述）列表是通过以分号 (;) 开头，并在术语后加上冒号 (:) 来定义的。

维基文本 渲染效果
Definition lists:

; Keyboard: Input device with buttons or keys
; Mouse: Pointing device for two-dimensional input

or

; Keyboard
: Input device with buttons or keys
; Mouse
: Pointing device for two-dimensional input

定义列表

键盘
带有按钮或按键的输入设备
鼠标
用于二维输入的指向设备

或者

键盘
带有按钮或按键的输入设备
鼠标
用于二维输入的指向设备
Use additional colons if a term has multiple definitions:

; Term
: First definition
: Second definition

如果术语有多个定义，请使用额外的冒号

术语
第一个定义
第二个定义
注意 定义列表不得仅仅为了格式化而使用。请参阅 Wikipedia:Help:Wikitext#Description lists 和 描述列表可访问性。

列表项中的代码块

列表中带有代码块的示例

维基文本 渲染效果
# First item
# Second item: {{bc|<nowiki>
code1
code2
code3
</nowiki>}}
# Third item
  1. 第一项
  2. 第二项
    code1
code2
code3
  3. 第三项

缩进

要缩进文本，请在行首放置一个冒号 (:)，: 后面接空格是 可选的。冒号越多，文本缩进越深。换行符标记缩进段落的结束。

维基文本 渲染效果
This is not indented at all.
: This is indented slightly.
:: This is indented more.

这根本没有缩进。

这稍微缩进了一点。
这缩进得更多。
注
  • 仅在为了获得所需布局而绝对必要时才使用缩进。
  • 在讨论页中，使用它来缩进回复（请参阅 Help:Discussion）。

代码

要向维基添加代码，请使用其中一个 代码格式化模板。或者，只需在每行开头加一个空格字符，例如：

 $ echo Hello World

另请参阅 Help:Style#Code formatting。

表格

提示 请参阅 Mediawiki 表格生成器 以自动生成表格。

如果使用得当，表格有助于组织和总结大量数据。有关高级表格语法和格式，请参阅 Wikipedia:Help:Table。

维基文本 渲染效果
{| class="wikitable"
|+ Tabular data
! Distro !! Color
|-
| Arch || Blue
|-
| Gentoo || Purple
|-
| Ubuntu || Orange
|}
表格数据
发行版 颜色
Arch 蓝色
Gentoo 紫色
Ubuntu 橙色
{| class="wikitable"
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on
|-
| rootfs || 922G || 463G || 413G || 53% || /
|-
| /dev || 1.9G || 0 || 1.9G || 0% || /dev
|}
文件系统 大小 已用 可用 使用率% 挂载点
rootfs 922G 463G 413G 53% /
/dev 1.9G 0 1.9G 0% /dev

链接对于帮助读者导航网站至关重要。通常，编辑者应确保每个条目都包含指向其他条目的输出链接（避免 孤立页面），并被其他条目的输入链接所引用（可以使用 链入页面 特殊页面显示输入链接）。另请参阅 Help:Style/Formatting and punctuation#First instances。

您可以使用内部链接广泛地交叉引用现有的维基页面。要创建指向同一维基中其他页面的链接，只需将标题放在双方括号中。

例如，如果您想创建指向 pacman 条目的链接，请使用：

[[pacman]]
注意 如果目标页面不存在，结果将是一个 红色链接，根据 Help:Style#Hypertext metaphor，应避免使用。

如果您想使用非条目标题的文字作为链接文本，可以使用竖线符号 ("|") 后的标签来提供替代文本。

例如：

The [[ArchWiki:About|ArchWiki]] is the primary documentation source for Arch Linux.

...渲染为

ArchWiki 是 Arch Linux 的主要文档来源。
提示 竖线符号 ("|")，也称垂直条，可以在英语键盘布局及类似布局上通过 Shift+\ 输入。

当您想在链接中使用条目标题的复数形式（或添加任何其他后缀）时，可以将多出的字母直接添加在双方括号之外。

例如：

makepkg is used in conjunction with [[PKGBUILD]]s.

...渲染为

makepkg 与 PKGBUILDs 一起使用。

要创建指向文档章节的链接，只需添加一个 #，后跟章节标题。

例如：

[[Help:Editing#Section links]]

...渲染为

Help:Editing#Section links
提示 如果链接到同一页面内的章节，可以省略页面名称（例如 [[#章节链接]]）。

管道技巧

在某些情况下，可以使用 管道技巧 来节省编写维基链接标签的时间。ArchWiki 上最常用的场景是：

  1. 在条目标题中，它允许隐藏语言后缀。例如，[[Main page (Česky)|]] 会转换为 Main page。
  2. 在指向不同命名空间或维基的链接中，管道技巧会隐藏前缀。例如，[[ArchWiki:About|]] 转换为 About，而 [[wikipedia:Help:Pipe trick|]] 转换为 Help:Pipe trick。

保存页面时，管道技巧将自动生成链接标签并相应地更改维基文本。

请参阅 Help:i18n#Interlanguage links

所谓的跨维基链接可以用于轻松链接到其他外部维基中的条目，例如维基百科。这种链接类型的语法是维基名称后跟冒号，以及用双方括号括起来的要链接到的条目。

如果您想创建指向 Wikipedia:Arch Linux 条目的链接，可以使用以下方法：

[[Wikipedia:Arch Linux]]

或者您可以创建一个带有链接标签的管道链接指向 Arch Linux 维基百科条目 

[[Wikipedia:Arch Linux|Arch Linux Wikipedia article]]
注意 使用带标签的管道链接应保留用于缩写较长的 URL。

请参阅 mw:Help:Links#Interwiki links。

ArchWiki 上可用的所有跨维基链接列表可以在 Special:Interwiki 和 通过 API 查看。

提示 默认情况下，所有指向维基百科页面的跨维基链接都被视为指向英语页面的链接。如果您想创建指向其他语言页面的链接，可以在页面名称前加上语言前缀。例如，要创建指向俄语页面的链接，请在其名称前加上 ru：[[Wikipedia:ru:Arch Linux]]

结果为 Wikipedia:ru:Arch Linux。请注意，这取决于目标维基的 跨维基配置，因此它并不适用于所有维基。但在维基百科上有效。

如果您想链接到外部站点，只需键入您要链接到的页面的完整 URL。 

https://archlinux.org.cn/

通常，为链接提供替代标签比显示 URL 更有用。与 #内部链接 不同，带标签的外部链接使用单方括号，并且目标 URL 和标签由空格（不是竖线）分隔。例如，要让链接显示为 Arch Linux，只需键入： 

[https://archlinux.org.cn/ Arch Linux]

也可以通过简单地将 URL 用单括号括起来来生成自动编号的标签。这通常比短语“请参阅 这里”更受欢迎。要生成短语“请参阅 [1]”（数字将根据页面上链接的顺序而变化），只需键入： 

see [https://archlinux.org.cn/]
注

重定向

要自动从一个页面 重定向（转发用户）到另一个页面，请在页面开头添加 #REDIRECT 和指向目标页面的内部链接。例如，您可以将“Penguins”重定向到“Penguin”： 

#REDIRECT [[Penguin]]

因此，在搜索框中键入任一版本的用户都将自动转到“Penguin”。

重定向还可以记录链接产生的原因，例如将它们分组在“链入页面”中，并允许在章节重命名时快速更新链接片段。缺点是重定向不会在浏览器中显示最终的链接目标。

在创建重定向之前，您可以执行搜索以检查是否存在兼容的重定向。例如，Xorg。

参见

注

维基变量、魔术字和模板

MediaWiki 可以识别条目中某些更改标准行为的特殊字符串。例如，在条目中添加 __NOTOC__ 将防止生成目录。同样，__TOC__ 可用于更改目录的默认位置。详情请见 Help:Magic words。

模板和变量是预定义的维基文本片段，可以插入条目中以辅助格式化内容。

变量由系统定义，可用于显示有关当前页面、维基或日期的信息。例如，使用 {{SITENAME}} 显示维基站点名称（此处显示为“ArchWiki”）。要为当前页面设置备选标题，可以使用另一个维基变量：{{DISPLAYTITLE:新标题}}。（但这受到严格限制：您只能将第一个字母改为小写并将空格替换为下划线——标准化标题字符串必须与实际页面名称匹配，否则无效；使用 {{Lowercase title}} 模板以小写显示标题的第一个字母）。

另一方面，模板是用户定义的。通过在条目中添加 {{命名空间:页面名称}}，可以将任何页面的内容包含在另一个页面中，但这很少用于Template命名空间之外的页面。（如果省略命名空间，则假定为Template）。例如 Template:Note，可以通过以下维基文本包含在条目中： 

{{Note|This is a note.}}

...渲染为

注意 这是一个提示。

请参阅 Help:Template 获取更多信息以及可用模板的 列表，例如 Template:Tip 或 Template:Warning。

取自 “https://wiki.archlinux.org.cn/index.php?title=Help:Editing&oldid=875667”

© . 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.