帮助:编辑
ArchWiki 由 MediaWiki 提供支持，MediaWiki 是一个用 PHP 编写的自由软件 Wiki 包，最初设计用于维基百科。更深入的帮助可以在 MediaWiki 上的 Help:Contents 和 维基百科上的 Help:Contents 中找到。
这是一个关于编辑 ArchWiki 的简短教程。在编辑或创建页面之前，鼓励用户熟悉现有文章的总体基调、布局和风格。应努力在整个 Wiki 中保持一定程度的一致性。请参阅 ArchWiki:Contributing、Help:Reading 和 Help:Style 以概述常用约定。
要进行编辑实验，请使用沙盒。有关 Wiki 标记的概述，请参阅 Help:Cheatsheet。
创建账户
在注册之前，请先熟悉我们的行为准则。要能够编辑 ArchWiki 文章，您必须创建一个 ArchWiki 账户并确认用于注册的电子邮件地址。回答验证码问题需要最新的 Arch Linux 环境：非常欢迎非 Arch 用户为 Wiki 做出贡献，为了回答这个问题，他们可以例如启动到带有最新安装镜像的 Arch Live 系统，使用 pacman-staticAUR（预编译二进制文件可用）或简单地使用利用 Docker 等工具的容器镜像。
拥有账户后，从 Special:UserLogin 登录。
编辑
要开始编辑页面，请单击页面顶部的编辑源代码标签。或者，用户可以通过单击章节标题右侧的编辑源代码链接来编辑文章的特定章节。将显示正在编辑页面名称或正在编辑页面名称（章节）页面，其中包含以下元素
- 编辑工具栏（可选）
- 编辑框
- 编辑摘要框
- 保存更改或保存页面、显示预览、显示更改和取消链接
编辑框将包含页面的当前修订版或章节的 wikitext（服务器从中生成网页的可编辑源代码）。要执行编辑
- 根据需要修改 wikitext（有关详细信息，请参阅下面的#格式化）。
- 在 摘要 框中解释编辑内容（例如，“修复错别字”或“添加了关于 xyz 的信息”）。注意：所有编辑都应附有描述性摘要，以方便其他用户审核。有关更多信息，请参阅 ArchWiki:Contributing#三大基本规则。
- 使用显示预览按钮有助于校对并在保存前验证格式。
- 如果编辑是表面性的且无可争议的，请选中这是一个小编辑框，将编辑标记为小编辑。
- 单击保存更改保存更改。如果不满意，请单击取消（或重复该过程直到满意为止）。
撤销编辑
如果页面编辑不正确，以下步骤描述了如何将文章恢复到以前的版本。要撤销单个编辑
- 单击要修改的页面顶部的查看历史标签（在编辑源代码标签旁边）。将显示修订列表。
- 单击不需要的编辑右侧的撤销链接。将显示编辑预览，左侧显示当前修订版，右侧显示要保存的文本。
- 在编辑摘要字段中写下您撤销此编辑的原因。
- 如果满意，请单击页面底部的保存更改按钮。
Wiki 页面现在应恢复到其原始状态。
有时，有必要一次撤销最近的几个编辑。要将文章恢复到以前的版本
- 单击要修改的页面顶部的查看历史标签（在编辑源代码标签旁边）。将显示修订列表。
- 通过单击相应的时间戳查看所需的修订版（即，上次良好的版本）。将显示该修订版。
- 单击页面顶部的编辑源代码标签。将显示警告警告：您正在编辑此页面的过时修订版。如果您保存它，自此修订版以来所做的任何更改都将丢失。
- 在编辑摘要字段中写下修订版时间戳（显示在页面顶部）以及您将页面状态恢复到该版本的原因。
- 如果满意，只需单击保存更改按钮即可恢复到此版本。
- 避免将撤销和编辑结合使用。先撤销编辑，然后再进行其他更改；不要编辑修订预览。
- 在执行撤销时，请考虑使用特别详细和冗长的编辑摘要，以防止冗长的讨论。
创建页面
在创建新页面之前，请考虑以下事项
- 您的主题与 Arch Linux 相关吗？不相关或无用的文章将被删除。
- 您的主题对其他人有意义吗？不仅要考虑您想写什么，还要考虑其他人可能想读什么。个人笔记属于您的用户页面。
- 您的主题值得创建一个新页面吗？在 Wiki 中搜索类似的文章。如果存在，请考虑改进或向现有文章添加章节。
- 您的贡献是否会很重要？除非计划在不久后扩展，否则请避免创建存根。
创建新页面需要选择一个描述性的标题和一个合适的类别。
请阅读Help:Article naming guidelines和Help:Style#标题以获取文章命名建议。请勿在页面标题中包含“Arch Linux”或变体。这是 Arch Linux Wiki；假设文章将与 Arch Linux 相关（例如，“安装 Openbox”；而不是“在 Arch Linux 中安装 Openbox”）。
访问目录以帮助选择合适的类别。文章可能属于多个类别，只要一个类别不是另一个类别的父类别（请参阅Help:Style#类别）。
要将新页面添加到某个类别（例如，“我的新页面”到“某个类别”），您需要
- 通过浏览到https://wiki.archlinux.org.cn/title/My_new_page创建一个带有新标题的页面（记住将“My_new_page”替换为预期标题！）
- 将
[[Category:Some category]]添加到页面的顶部
在此阶段，新文章仍被视为孤立页面。要完成这项工作，请花一点额外的时间从其他文章链接到新文章：这将提高其可见性，并鼓励更多用户为其做出贡献。可能的候选者是关于相关软件的文章、更通用的概述页面，甚至是简单的列表，例如应用程序列表。
在某些情况下，创建子页面（即另一个页面的子页面）可能更有意义：子页面标题用“/”符号（斜杠）与父页面标题分隔。这通常用于在自己的用户页面下准备草稿，例如https://wiki.archlinux.org.cn/title/User:Myself/My_new_subpage。
格式化
文本格式化尽可能使用 Wiki 标记完成；学习 HTML 不是必需的。各种模板也适用于常见的格式化任务；有关模板的信息，请参阅Help:Template。Help:Cheatsheet总结了最常见的格式化选项。
标题和小标题
标题和小标题是改进文章组织结构的简单方法。如果您可以看到正在讨论的不同主题，则可以通过为每个章节插入标题来分解文章。有关样式信息，请参阅Help:Style#章节标题和Help:Effective use of headers。
标题必须从二级标题开始，可以像这样创建
== Second-level heading == === Third-level heading === ==== Fourth-level heading ==== ===== Fifth-level heading ===== ====== Sixth-level heading ======
如果文章至少有四个标题，则会自动生成目录 (TOC)。如果不需要目录，请在文章中放置 __NOTOC__。尝试在沙盒中创建一些标题，看看对目录的影响。
换行
空行用于开始新段落，而单行换行在常规段落中不起作用。
HTML <br> 标签可用于手动插入换行符，但应避免使用。手动换行可能适用于其他格式化元素，例如列表。
| wikitext | 渲染 |
|---|---|
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。
粗体和斜体
粗体和斜体是通过用两个、三个或五个单引号 (') 包围单词或短语来添加的
| wikitext | 渲染 |
|---|---|
|
|
斜体 |
|
|
粗体 |
|
|
粗体和斜体 |
删除线
使用删除线文本来表明文本不再适用或不再相关。
| wikitext | 渲染 |
|---|---|
<s>Strike-out text</s> |
|
列表
请记住，Wiki 语法不支持多行列表项；每个换行符都会结束列表项定义。要在列表项内开始新行，请使用 <br> 标签。要在列表项内输入多行代码块，请使用Template:bc并使用 <nowiki> 标签转义内容。另请参阅Help:Style/White space和Help:Template。
项目符号
项目符号没有明显的项目顺序。
要插入项目符号，请使用星号 (*)。多个 * 将增加缩进级别。
| wikitext | 渲染 |
|---|---|
* First item * Second item ** Sub-item * Third item |
|
编号列表
编号列表引入编号，从而对列表项进行排序。只要项目中出现的顺序不是主要关注点，您通常应使用无序列表。
要创建编号列表，请使用数字符号或井号 (#)。多个 # 将增加缩进级别。
| wikitext | 渲染 |
|---|---|
# First item # Second item ## Sub-item # Third item |
|
# First item # Second item #* Sub-item # Third item |
|
定义列表
定义列表使用前导分号 (;) 和术语后的冒号 (:) 定义。
| wikitext | 渲染 |
|---|---|
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 |
如果一个术语有多个定义，请使用其他冒号
|
定义列表不得仅用于格式化，请参阅W3 的示例。
列表项中的代码块
列表中的代码块示例
| wikitext | 渲染 |
|---|---|
# First item
# Second item: {{bc|<nowiki>
code1
code2
code3
</nowiki>}}
# Third item
|
|
缩进
要缩进文本，请在行首放置冒号 (:)。您放置的冒号越多，文本的缩进就越远。换行符标记缩进段落的结尾。
| wikitext | 渲染 |
|---|---|
This is not indented at all. :This is indented slightly. ::This is indented more. |
这完全没有缩进。
|
代码
要向 Wiki 添加代码，请使用代码格式化模板之一。或者，只需以单个空格字符开始每行，例如
$ echo Hello World
另请参阅Help:Style#代码格式化。
表格
有效使用表格可以帮助组织和总结大量数据。有关高级表格语法和格式的信息，请参阅Wikipedia:Help:Table。
| wikitext | 渲染 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{| class="wikitable"
|+ Tabular data
! Distro !! Color
|-
| Arch || Blue
|-
| Gentoo || Purple
|-
| Ubuntu || Orange
|}
|
| ||||||||||||||||||
{| class="wikitable"
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on
|-
| rootfs || 922G || 463G || 413G || 53% || /
|-
| /dev || 1.9G || 0 || 1.9G || 0% || /dev
|}
|
|
链接
链接对于帮助读者浏览站点至关重要。一般来说，编辑应确保每篇文章都包含指向其他文章的外向链接（避免死胡同页面），并被其他文章的内向链接引用（链入页面特殊页面可用于显示内向链接）。另请参阅Help:Style/Formatting and punctuation#首次出现。
内部链接
您可以使用内部链接广泛地交叉引用现有的 Wiki 页面。要链接到同一 Wiki 上的另一个页面，只需将标题放在双括号中即可。
例如，如果您想链接到pacman文章，请使用
[[pacman]]
如果您想使用文章标题以外的词语作为链接文本，您可以使用管道符号 (“|”) 后的标签来提供替代文本。
例如
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]]
...渲染为
[[#章节链接]]）。管道技巧
在某些情况下，可以使用管道技巧来节省编写 Wiki 链接标签的时间。ArchWiki 上可用的最重要的情况是
- 在文章标题中，它允许隐藏语言后缀。例如，
[[Main page (Česky)|]]变为 主页。 - 在链接到不同的命名空间或 Wiki 时，管道技巧会隐藏前缀。例如，
[[ArchWiki:About|]]变为 关于，[[wikipedia:Help:Pipe trick|]]变为 Help:Pipe trick。
保存页面后，管道技巧将自动生成链接标签并相应地更改 Wiki 文本。
跨语言链接
跨 Wiki 链接
所谓的跨 Wiki 链接可用于轻松链接到其他外部 Wiki 中的文章，例如维基百科。此链接类型的语法是 Wiki 名称，后跟冒号和要链接到的文章，并用双括号括起来。
如果您想创建指向Wikipedia:Arch Linux文章的链接，您可以使用以下内容
[[Wikipedia:Arch Linux]]
或者您可以创建一个带标签的管道链接到Arch Linux 维基百科文章
[[Wikipedia:Arch Linux|Arch Linux Wikipedia article]]
ArchWiki 上可用的所有跨 Wiki 链接的列表可以在Special:Interwiki和通过 API查看。
ru[[Wikipedia:ru:Arch Linux]]请注意，这取决于目标 Wiki 的跨 Wiki 配置，因此它并非在每个 Wiki 上都有效。但它适用于维基百科。
外部链接
如果您想链接到外部站点，只需键入要链接到的页面的完整 URL 即可。
https://archlinux.org.cn/
通常，给链接一个替代标签而不是显示 URL 更有用。与#内部链接不同，带有标签的外部链接使用单括号，目标 URL 和标签用空格分隔（不是管道）。例如，要使链接显示为Arch Linux，只需键入
[https://archlinux.org.cn/ Arch Linux]
也可以通过仅用单括号括起 URL 来生成自动编号的标签。这通常比“请参阅此处”之类的短语更可取。要生成短语“请参阅[1]”，其中的编号将根据页面上链接的顺序而变化，只需键入
see [https://archlinux.org.cn/]
- 当链接到其他 ArchWiki 页面时（即，链接以https://wiki.archlinux.org.cn/开头），请使用#内部链接。当链接到维基百科页面时（即，链接以https://en.wikipedia.org/开头），请使用#跨 Wiki 链接。
- 当链接到 gitlab.archlinux.org 上的问题时，请改用 Template:Issue。
- 当链接到软件包或软件包组时，请使用相应的模板。请参阅Help:Style#软件包管理说明。
重定向
要从一个页面自动重定向到另一个页面，请在页面开头添加 #redirect 和指向要重定向到的页面的内部链接。
例如，您可以将“Penguins”重定向到“Penguin”，如下所示
#redirect [[Penguin]]
因此，在搜索框中键入任一版本的人都会自动转到“Penguin”。
重定向还允许跟踪链接创建的原因，例如将它们分组在链入页面页面中，并在章节重命名的情况下快速更新链接片段。缺点是重定向不会在浏览器中显示最终链接目标。
在创建重定向之前，您可以执行搜索以检查现有的兼容重定向。例如，Xorg。
另请参阅Help:Style#重定向页面和Help:Procedures#处理将页面重定向到另一个页面后的讨论页。
- 重定向不应指向其他站点。
- 重定向不适用于分类页面。
- 重定向由服务器在内部解析，并且不会降低打开文章的速度。
- 将现有页面重定向到另一个页面可能会创建双重重定向：有关修复双重重定向的信息，请参阅Help:Procedures#修复双重重定向。
Wiki 变量、魔术字和模板
MediaWiki 识别文章中的某些特殊字符串，这些字符串会改变标准行为。例如，在文章中的任何位置添加单词 __NOTOC__ 将阻止生成目录。同样，单词 __TOC__ 可用于更改目录的默认位置。有关详细信息，请参阅Help:Magic words。
模板和变量是 Wiki 文本的预定义部分，可以插入到文章中以帮助格式化内容。
变量由系统定义，可用于显示有关当前页面、Wiki 或日期的信息。例如，使用 {{SITENAME}} 显示 Wiki 的站点名称（此处显示为“ArchWiki”）。要为当前页面设置备用标题标题，可以使用另一个 Wiki 变量：{{DISPLAYTITLE:新标题}}。（但这非常受限：您只允许将首字母更改为小写，并将空格替换为下划线 - 规范化的标题字符串必须与实际页面名称匹配，否则它将不起作用；使用 {{Lowercase title}} 模板以小写形式显示标题的首字母）。
另一方面，模板是用户定义的。任何页面的内容都可以通过将 {{Namespace:Page Name}} 添加到文章中来包含在另一个页面中，但这很少用于Template命名空间之外的页面。（如果省略命名空间，则假定为Template。）例如，Template:Note，可以使用以下 Wiki 文本包含在文章中
{{Note|This is a note.}}
...渲染为
有关更多信息和可用模板的列表，例如Template:Tip或Template:Warning，请参阅Help:Template。