Help:编辑

来自 Arch Linux 中文维基
(重定向自Help:Editing (简体中文)

ArchWiki 使用的 MediaWiki 是一个用 PHP 写成的软件包,最早用于维基百科。更深入的帮助请查看 MediaWiki 帮助(英文)和中文维基百科的帮助

本文仅介绍编辑和创建页面的方法和页面语法,在编辑或创建页面之前,请阅读 Project:贡献, 风格阅读帮助,了解一下现有文章的语言、布局和样式,在后续的编辑中请尽量保持统一。请使用沙盒进行编辑尝试。这里有一个关于 wiki 标记语言的概览。

创建账号[编辑 | 编辑源代码]

创建账号后方可编辑本中文 Wiki 内容,要编辑英文 Wiki 内容,请先创建英文 ArchWiki 账号。要回答英文账号创建时的问题,需要一个Arch Linux 环境或者 pacman-staticAUR 或者 Docker 镜像。我们也鼓励非 Arch 用户参与 wiki 贡献,请下载最新的安装环境,在 Live 系统中就可以获得问题的答案。创建账号后,登录系统。

编辑[编辑 | 编辑源代码]

要开始编辑一个页面,点击页面顶端或者章节旁边的编辑链接,可进行所见即所得编辑。也可以点击页面顶端的编辑源代码标签。用户也可以通过点击章节头部的编辑源代码链接编辑文章的特定部分。点击后将会显示编辑源代码页面,包含如下元素:

  • 编辑工具栏 (可选)
  • 编辑框
  • 编辑总结
  • “保存本页”,“显示预览”,“显示更改”和“取消”链接
  • 保存更改保存页面, 显示预览, 显示更改取消 链接

编辑框包含页面或章节最新版本的 wiki文字 (服务器可以生成实际页面的源代码) 。进行编辑:

  1. 按需编辑 wiki 内容(详情参见下面的#格式).
  2. 摘要框中解释所作修改(例如: "错字更正" 或是 "新增关于 xyz 的信息")。
    注意: 所有的编辑都应该附有描述性的摘要,以方便其他用户的审查。更多信息参见三个基本原则
  3. 使用 显示预览 按钮在保存前检查页面的排版与格式。
  4. 如果修改没有太多实质性内容,请通过点击 这是小编辑 将编辑标记为 小修改
  5. 通过 保存更改 按钮保存。如果不满意,可以点击 取消(或继续完善)。
注意: 文章不应该署名,因为它们是合作成果;一个编辑者不应在众人的劳动成果上署名。

撤销编辑[编辑 | 编辑源代码]

如果页面编辑错误,可以采用如下步骤将文章回溯到上一个版本。要撤销单个编辑:

  1. 点击要修改页面顶部的查看历史标签(在编辑标签旁边),将显示版本列表。
  2. 点击错误修改右边的撤销链接,将显示编辑预览,左侧显示当前版本,右侧显示要保存的版本。
  3. 记录撤销的原因
  4. 如果满足要求,点击页面底部的保存更改按钮。

Wiki 页面将回到原始状态。

有时需要同时撤销多个编辑,要回溯到以前的版本:

  1. 点击要修改页面顶部的 查看历史 标签(在 编辑 标签旁边),将显示版本列表。
  2. 通过点击相应的时间戳查看需要的版本(即最后的版本),将显示那个版本。
  3. 记录时间戳和回退到之前状态的原因。
  4. 如果满足要求,点击页面底部的 编辑 标签,将显示警告:警告:您正在编辑该页面的旧版本。如果您发布该更改,该版本后的所有更改都会丢失。。只需要点击 保存更改 就可以回到这个版本。
注意: 请避免同时进行撤销和编辑!先撤销,然后进行修改;不要编辑版本预览。

如果是撤销编辑,请尽量写一个详细和丰富的编辑说明。

创建页面[编辑 | 编辑源代码]

创建新页面前,请考虑如下内容:

  1. 您的话题是否和 Arch Linux 相关?无关和没什么帮助的文章将被删除。
  2. 别人是否对您的话题感兴趣? 不仅考虑您想写什么,还要考虑别人想读什么。个人信息应该放在你的用户页面。
  3. 您的话题是否值得增加单独页面?在 wiki 中查找相似文章,如果已经存在,可以考虑完善它或者新增一个章节。
  4. 您是否愿意贡献足够的内容?请避免仅添加话题,除非计划很快就会扩展和完善它。

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

请阅读文章命名指导选择短文件名获取文章命名经验。

  1. 标题应该包含大小写:使用Title for New Page;而不是 Title for new page
  2. 不要包含 "Arch Linux" 之类的修饰。这是 Arch Linux wiki;所有的文章都与 Arch Linux 相关(例如使用 Installing Openbox; 而不是 Installing Openbox in Arch Linux)。

访问目录列表选择一个合适的类别。 文章可以属于多个类别。

要在某个分类中添加新文章,(例如添加 "My New Page" 到 "Some Category"),您只需要:

  1. 通过浏览 https://wiki.archlinuxcn.org/wiki/My_new_page 创建一个页面(别忘了替换 "My_new_page"!)
  2. 在您页面的顶端添加[[Category:Some Category]]
注意: 不要创建无分类的页面! 任何页面都必须属于至少一个分类。如果找不到合适的分类,请考虑创建一个分类。简体中文文章应该添加[[Category:简体中文]]

这些页面目前还是孤立页面,请花些时间将其与其它页面链接起来,这样用户更容易找到它,并贡献内容。

若您创建的新页面是 ArchWiki 上其他语言的本地化版本,那么请遵循下面的步骤:

注意: ArchWiki 上面的非英文文章统一遵循了 英文名_(语言) 的命名规范(例如 Main_page_(简体中文))
  1. 翻译文章标题(如果文章标题不需要翻译则跳过本条)
  2. 使用翻译后的文章标题在本站创建页面,标题中去掉 ArchWiki 中的语言信息(例如:为 Main_page_(简体中文) 创建本地化的标题应为首页而不是首页_(简体中文)首页_(正體中文))。
  3. 在本站创建重定向,将 ArchWiki 上的原标题重定向至上一步中创建的页面。(例如:将 Main_page_(简体中文) 重定向到首页)。

部分情况下可以创建子页面,也就是某个页面下的页面。子页面的标题格式一般是父页面标题+斜杠(“/”)+子页面标题。子页面功能一般可以用于在自己的用户页下创建页面草稿,比如https://wiki.archlinuxcn.org/wiki/User:Myself/My_new_subpage

格式[编辑 | 编辑源代码]

大部分的文字显示格式都可以用 wiki 内置的标记语法(称为wikitext)来实现,你不需要学习使用 HTML。常用的工作可以通过模板实现,模板页面包含模板使用的相关信息。速查表整理了常用的格式选项。

标题与子标题[编辑 | 编辑源代码]

标题和子标题是提高文章的组织结构的常用方法。如果讨论了两个或两个以上的主题,可以在文章内为每个章节添加一个标题。请阅读有效使用标题获取更多信息。

标题创建:

==一级标题==
===二级标题===
====三级标题====
=====四级标题=====
  1. 标题的大小写遵照句子规范而不是标题规范,使用 My new heading 而不是 My New Heading
  2. 不应该跳过标题级别,也就是说,没有在二级标题之内就不要使用三级标题。

如果一篇文章使用四个以上的标题,系统会自动生成内容列表 (TOC)。如果不想使用内容列表,你可以在页面中添加 __NOTOC__。 请试着在沙盒内建立几个标题,然后看看他们对内容列表的影响。

换行[编辑 | 编辑源代码]

重要格式提示: 布局中单个换行是没有效果的,所以

这句话
被分成
三行。

...将显示为:

这句话 被分成 三行。

空行将新起一个段落,例如:

这是第一段。

这是第二段。

...将显示为:

这是第一段。

这是第二段。

HTML <br> 也可以实现手动换行,但是应该避免这么做。手动换行还会在其他格式元素中使用, 例如列表(后面会详细讲解列表):

* 这个点 <br> 扩展到多行
* 这个点
结束列表

...将显示为:

  • 这个点
    扩展到多行
  • 这个点

结束列表

粗体与斜体[编辑 | 编辑源代码]

文字放在数个单引号 (') 之间将表现出 Bold - 粗体italics - 斜体的效果:

  • ''italics - 斜体'' 显示为 italics - 斜体. (前后加上两个单引号)
  • '''bold - 粗体''' 显示为 bold - 粗体. (前后加上三个单引号)
  • '''''bolded italics - 粗体斜体字''''' 显示为 bolded italics - 粗体斜体字. (前后加上 2 + 3 =  五个单引号)
注意: 中文的斜体字很不美观,字形非常贴近后面的文字,影响阅读,翻译时请尽量用双引号或者粗体替换。在有合适的字体时(如 ttf-lxgw-wenkaiCNRepo),本维基上的斜体中文会显示为楷体或者仿宋体

删除线[编辑 | 编辑源代码]

用删除线表示文字已经没有作用或者无关。

例如:

<s>删除的文字</s>

...显示为

删除的文字

要点列表[编辑 | 编辑源代码]

请使用星号 (*)插入一个新要点。插入星号越多,缩进越多。

例如:

*第一条
*第二条
**第二条的子项
*有趣吗?

显示为:

  • 第一条
  • 第二条
    • 第二条的子项
  • 有趣吗?

编号列表[编辑 | 编辑源代码]

要建立编号列表,请使用数字符号或是井字号 (#)。多个井字号 # 将增加缩进层次。

例如:

# 第一条
# 第二条 
## 子条目
# 第三条 

...将显示为:

  1. 第一条
  2. 第二条
    1. 子条目
  3. 第三条

编号列表可以和要点列表混合使用,例如:

# 第一条
# 第二条 
#* 子条目
# 第三条 

...将显示为:

  1. 第一条
  2. 第二条
    • 子条目
  3. 第三条

定义列表[编辑 | 编辑源代码]

可以通过在行首使用分号(;) + 定义名称 + 冒号(:) + 定义说明 生成定义列表。

例如:

; Apple: Fruit with red or yellow or green skin and sweet to tart crisp whitish flesh
; Banana: Elongated crescent-shaped yellow fruit with soft sweet flesh

...将显示为:

Apple
Fruit with red or yellow or green skin and sweet to tart crisp whitish flesh
Banana
Elongated crescent-shaped yellow fruit with soft sweet flesh

可以使用多个冒号将定义分成多行。

例如:

; Term: First line of definition
: Second line of definition
: Third line of definition

...将显示为:

Term
First line of definition
Second line of definition
Third line of definition

缩进[编辑 | 编辑源代码]

要缩进文字,请在行首插入冒号 (:) 。插入冒号越多,文字就缩进越多。新行(按下 Enter 或是 Return 后) 将结束整段文字的缩进。

例如:

这行靠最左对齐。
:这行稍微缩进。
::这行缩进更多

显示为:

这行靠最左对齐。

这行稍微缩进。
这行缩进更多。

在内容页面中,仅在必须时再使用缩进。在讨论页中,请用缩进区分回复。例如:

话题话题话题话题话题--~~~~
:回复1--~~~~
::回复1回复1--~~~~
::回复1回复2--~~~~
:回复2--~~~~
::回复2回复1--~~~~
:::回复2回复1回复1--~~~~
::回复2回复2--~~~~

即,要回复某条,就相对于被回复的层数再缩进一层。对于缩进非常多的情况,其他wiki会相应再使用一些模板标识,但本wiki暂无。

代码[编辑 | 编辑源代码]

在 wiki 页面使用代码格式非常简单:你只需要在每一行文字前加上一个空格。然而请注意行宽,因为代码不会自动断行。

注意,如果空格之后有冒号,需要将空格写作 &#32;,以避免被 wiki 自动转换不换行空格(nbsp)。例如以下代码并不能直接复制后运行:

$ fc-list : file

而这样则可以:

$ fc-list : file

也可以使用 <syntaxhighlight> 标签来通过站点的Pygments软件高亮代码,详见 SyntaxHighlight 扩展页面。使用可视化编辑器则可以直接从工具栏调整格式或者插入代码块。

另请参见代码格式模板

表格[编辑 | 编辑源代码]

有效使用表格可以帮助组织和汇总大量数据。高级表格语法和格式请查看 Help:Table.

例如:

{| border="1"
|+ 表格数据
! 水果!! 颜色
|-
| 苹果 || 红色
|-
| 橘子 || 橙色
|-
| 香蕉|| 黄色
|}

...将被显示为:

表格数据
水果 颜色
苹果
橘子
香蕉
{| class="wikitable" border="1" cellpadding="5" cellspacing="0"
! RAID 级别 !! 数据 !! 使用!! 读 !! 写!! 稀疏!! 最大!! 最小
|-
| 0 || 否 || 100% || 好 || 好|| No || 1 || 16
|-
| 1 || 是|| 50% || 非常高 || 非常高 || No || 2 || 2
|}

显示为:

RAID 级别 数据 使用 稀疏 最大 最小
0 100% No 1 16
1 50% 非常高 非常高 No 2 2

链接[编辑 | 编辑源代码]

链接是用帮助使用者浏览网站的关键。编辑者应该确保每篇文章都包含到其它文章的链接(避免断链页面)并被其它文章引用。链入页面可以用来显示链入的页面。参考 Help:Style/Formatting and punctuation#First instances.

内部链接[编辑 | 编辑源代码]

你可以大量应用内部链接交叉引用 Wiki 页面。链接目标可以是已经存在的标题,或是之后应该存在的标题。

在同一 wiki 内,要链接一个页面,只需要用双中括号包含要链接页面的标题。

例如,如果你想要设定个链接到文章 pacman,只需要:

[[pacman]]

如果希望使用页面标题以外的文字作为链接的标题,可以通过在链接和要使用的名字间插入 "|" 分隔符实现(在英文键盘上,使用Shift + \打出 "|")。

例如

查看 [[Arch Linux (简体中文)|这篇]]  文章...

...将显示为:

查看这篇文章...

如果希望在链接的页面名称后面加上复数 (或是任何后缀文字),可以把要加的文字直接放在包着链接页面的中括号后面。

例如:

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

...将显示为:

makepkg is used in conjunction with PKGBUILDs.
到文档章节的链接[编辑 | 编辑源代码]

要链接到文章的某个章节,只需要添加 # 加章节标题。

例如:

[[ArchWiki Tutorial (简体中文)#到文档章节的链接]]

...将显示为:

ArchWiki Tutorial (简体中文)#到文档章节的链接
提示:
  1. 如果链接到同页面的章节,可以省略文档名(例如, [[#到文档章节的链接]])。
  2. 如果有相同名称的章节,又想链接到第二个该名称的章节,可以在章节名后添加下划线加数字,例如: [[ArchWiki Tutorial (简体中文)#到文档章节的链接_2]]。
注意: 如果目标页面不存在,将显示为 red link,根据 Help:Style#Hypertext metaphor,请尽量避免这种情况。

多国语言链接[编辑 | 编辑源代码]

请访问跨语言链接

跨 Wiki 链接[编辑 | 编辑源代码]

跨 Wiki 链接可以链接到其他 Wiki 文章,例如 Wikipedia。这种链接的语法格式为双中括号 Wiki 名称加冒号加要链接的文章。

要链接到文章 Wikipedia:Arch Linux,可以使用:

[[Wikipedia:Arch Linux]]

通过管道可以用新的名字显示链接。例如到 Arch Linux Wikipedia article 的链接:

[[Wikipedia:Arch Linux|Arch Linux Wikipedia article]]
注意: 用管道链接设定新名字的方式只应该用于缩短长地址。

参见: Wikipedia:InterWikimedia links

站外链接[编辑 | 编辑源代码]

要链接到外部网站,请直接写出目标网页的完整 URL。

https://archlinux.org/

在很多时候,我们都会给链接的 URL 设定含意比较清楚的名称。 把链接的 URL 放在中括号内,然后在 URL 后加上一个空格 (不是 pipe)。要显示, Arch Linux ,可以使用:

[https://archlinux.org/ Arch Linux]
注意: 如果链接到其它 ArchWiki 或 Wikipedia 页面,请使用#内部链接#跨 Wiki 链接 而不是外部链接!也就是说,如果链接以 https://wiki.archlinux.org/ 开始,请使用内部链接; 如果以 https://en.wikipedia.org/ 开始,使用跨 wiki 链接!

重定向[编辑 | 编辑源代码]

要把一个页面自动跳转到另一个,请使用 #REDIRECT 这个指令,同时把新转过去的网页名称放在括号内。

例如,你可以设定把 "Cats" 这个页面自动转向 "Cat":

#REDIRECT [[Cat]]

这样,不管使用者在搜索里输入的是哪一个,他们都会进入 "Cat" 这个页面。

重定向之后的文字都不会被显示,然而类别标签仍然会起作用,以保证重定向会包含在类别列表中。

  • 不应该重定向到其它网站
  • 分类页面不支持重定向.
  • 重定向是服务器内部解析,不会影响页面的打开速度。

Wiki 变量、特殊字符和模板 (templates)[编辑 | 编辑源代码]

MediaWiki 识别一些改变标准行为的特殊字符串。例如,在文章任意位置加入 __NOTOC__ 将不会生成内容列表。而 __TOC__ 将改变内容列表的位置。详情参见 mw:Help:Magic words

模板和变量为事先定义的 wiki 文字,加入文章后会增加格式化的内容。

变量由系统定义,用来显示当前页面的信息、wiki 或者日期。例如,使用 {{SITENAME}} 显示 Wiki 网站的名字(本 Wiki 为 Arch Linux 中文维基)。要为页面设置新标题,可以使用变量:{{DISPLAYTITLE:新标题}} (仅允许大小写更改)。

模板则为用户定义。任意页面的内容都可以被其它页面引用,只需要在文章中加入 {{命名空间:页面名称}} 。但是除 Template 命名空间之外,这个功能很少被使用。(如果忽略命名空间,默认为Template。) 例如, Template:注意,可以通过在文章中加入如下内容引用:

{{注意|这是个注释。}}

...将显示为:

注意: 这是个注释。

更多信息请查看 Help:模板

使用机器人编辑[编辑 | 编辑源代码]

如果您的编辑需要进行大量或重复的修改,则可以考虑使用机器人编辑。

注册机器人账户[编辑 | 编辑源代码]

  1. 登录主账户。
  2. 访问 Special:创建账户
  3. 以主账户用户名+“.bot”为用户名注册。

使用机器人账户编辑[编辑 | 编辑源代码]

这部分请参考 Wikipedia:制作机器人