ArchWiki 使用教学 (简体中文)
From ArchWiki
- 这是一篇关于如何使用 Arch Linux Wiki 的简短教学文章。 详情请参阅 Help:Editing
- 如果你希望测试一下这篇教学里面关于编辑 Wiki 的语法,请使用 sandbox 这一页来练习。
i18n |
---|
Deutsch |
English |
Italiano |
Polish |
Česky |
Français |
Português do Brasil |
Español |
简体中文 |
繁體中文 |
Српски |
Русский |
Contents |
注册与登录
如果你只想浏览 Wiki 网页的內容,你不需要注册或是登录。要注册一个帐号 (注册帐号是免费的喔),请点选在每个页面最上方右边的 "建立一个帐号或是登录" 这个链接。你只需要登录一次就可以编辑每个页面的內容。
编辑页面
就像所有的维基一般 (wikis),你可以编辑所有不在 保护模式 下的网页。所有的改变都可以在更新后马上呈现。要编辑一个页面,请直接点选每个页面上方的 "edit" 这个链接。
请使用在编辑视窗和储存与预览按钮之间的 "Summary" 这一个输入栏来注明你对网页作了哪些更动。例如 : "错字更正" 或是 "新增关于 xyz 的资讯" 。
在储存页面前,请使用 show preview 这个按钮来检查你正在编辑的页面的排版与格式。请记得在预览后点选 save 来储存你的编辑页面。
如果你已经成功 登录 ,你可以使用 This is a minor edit 这个选项来标示你的编辑只是个小改变 minor (例如错別字,格式排列的改变),让其他人知道你并沒有对整篇页面的內容作任何大更动。
现在轮到你试着来练习一下如何编辑 wiki 页面了。使用网页浏览器,在新的分页打开 沙盒 (沙盒就是用来让你可以任意测试 wiki 语法),然后点选页面上方的 "edit" 这个链接。在编辑视窗內加入一些东西,然后点选 save 这个按钮。
文字显示格式
大部分的文字显示格式都可以用 wiki 內建的 markup 语法来实现,你不需要特別学习怎麼使用 HTML.
粗体与斜体
你可以把文字放在数个单引号 (') 之间来表现出 Bold - 粗体 和 italics - 斜体 的效果:
- ''italics - 斜体'' 显示为 italics - 斜体. (在文字的前后分別加上两个单引号)
- '''bold - 粗体''' 显示为 bold - 粗体. (在文字的前后分別加上三个单引号)
- '''''bolded italics - 粗体斜体字''''' 显示为 bolded italics - 粗体斜体字. (在文字的前后分別加上 2 + 3 = 五个单引号)
主标题与子标题
妥善使用主标题和子标题可以让你的文章的架构看起来更为完整与清楚。如果你的页面的內容可以整理出两个或更多个比较大的主题,你可以在你的文章內插入一些主标题来分出段落和增加文章的可读性。
标题可以用下面的语法来表现 :
- =主标题= (1 个等号)
- ==子标题== (2 个等号)
- ===再往下一层=== (3 个等号)
- ====再往下一层==== (4 个等号)
- =====再往下一层===== (5 个等号)
如果一篇文章有至少超过三个以上的标题,一个标题索引 (table of contents - TOC) 就会被自动生成。如果你不希望在页面內使用 TOC,你可以在页面的最上方加上 __NOTOC__ 这个指示字。 试着在 沙盒 內建立几个标题,然后看看他们对 TOC 起的作用。
Indenting 缩进
To indent text, 请在每一行文字的第一个位置插入一个冒号 (:) 。如果你插入越多个冒号,这一行文字就会越往內缩进。新的一行 (按下 Enter 或是 Return 后) 将会结束整段文字的缩进。
例如 :
This is aligned all the way to the left. :This is indented slightly. ::This is indented more.
显示为 :
This is aligned all the way to the left.
- This is indented slightly.
- This is indented more.
Bullet points - 无序号条列
要插入一个新条列时,请使用星号 (*)。就如同在文字缩进时一样,在每段文字前插入越多个星号,将可把整段文字依序往內缩进。
一个简单的例子 :
*First list item *Second list item **Sub-list item under second *Isn't this fun?
显示出来为 :
- First list item
- Second list item
- Sub-list item under second
- Isn't this fun?
有序号条列 - Numbered lists
你也可以在 wiki 页面上建立一个有序号的条列。要建立有序号条列时,请使用数字符号或是井字号 (#)。多个井字号 #s 可以共用,并表现出层次和缩进的效果。
例子 :
#First item #Second item ##Sub-item under second item #Third item
显示为 :
- First item
- Second item
- Sub-item under second item
- Third item
Code 源码
在 wiki 页面设定 Code 格式非常简单 : 你只需要在每一行文字前加上一个空白。
Links 链接
在 wiki 页面內使用链接的主要目的是用来帮助使用者浏览你的网站。
內部链接
你可以在一个页面內使用內部链接来设定多个 cross-reference wiki pages。你可以加入链接到一些已经存在的主题 (页面),或是设定链接到一些你认为之后应该会存在的主题 (页面)。
在同一个 wiki 文件內,要设定页面的链接时,你只需要把要链接的页面的标题放到双中括号內 (double square brackets) 即可。
例如,如果你想要设定个链接到 Wikia 这个页面,请使用下面这个格式 :
- [[Wikia]]
如果你希望使用页面标题以外的文字作为链接的名字,你可以使用 "|" 这个 pipe divider 然后在后面加上你要使用的链接名字 (在英文键盘上,你可以使用 SHIFT + BACKSLASH 的方式打出 "|")。
例如,如果你希望设定一个链接到 Arch Linux 这一页,但是想用 "home page" 来代表这个链接,你可以使用下面这个格式 :
- 请参阅 [[Arch Linux|home page]]...
然后页面內容就会显示 :
- 请参阅 home page...
如果你希望为链接的页面主题名称加上复数 (或是加上任何后缀文字),你可以把要加上的文字直接放在包着链接页面的中括号后面。
例如,你可以用 :
- Add questions to the Arch Linux for [[quiz]]zes.
页面內容的显示将会是 :
- Add questions to the Arch Linux for quizzes.
多国语言链接
ArchWiki 允许你使用不同的语言来编写页面的內容。如果不同语言的页面有着相同的主题,我们最好在这些页面上都设定个链接到不同语言的版本的页面。 对於有不同的语言的版本的相同的文章,ArchWiki 允许你在每个页面上设定一个 "i18n-box" ,让你列出相同页面,但是以各种语言编写的链接。
要在一个页面上加入一个 i18n-box,请在页面內加入下面这几行指令:
{{i18n_links_start}} {{i18n_entry|Deutsch|German Title of the Article}} {{i18n_entry|Français|French Title of the Article}} {{i18n_entry|简体中文|简体中文页面标题}} {{i18n_entry|繁体中文|繁体中文页面标题}} {{i18n_links_end}}
如果非英文页面使用的标题和英文的相同,那非英文页面的标题就该使用下面这种格式
标题名称 (语言)
例如 :
Gnome Gnome (Deutsch) Gnome (Français) Gnome (简体中文) Gnome (繁体中文)
Wiki文件间链接
要链接到其他的 wiki 文件时,你可以使用 title 后面接着一个分号然后是页面的名称。使用这个方法,你就不需要把完整的 URL 都打出来了。
例如, creatures wiki 首页是在 Creatures:Main Page ,这时你就可以用
- [[Creatures:Main Page]]
- 而不需要键入 http://wiki.archlinux.org/index.php/Main_Page
站外链接
如果你希望在页面內链接到 Wikicities (指的就是 wiki 站內的文章集合) 以外的网站,你只需要在页面內键入完整的网站链接路径 (URL) 即可。
在很多时候,我们都会给予链接的 URL 一个比较含意比较清楚的文字名称。你可以把链接的 URL 放在中括号內,然后在 URL 后加上一个 空白 (space) (不是 使用 pipe) 后,再键入你要使用的链接文字名称。所以,如果你想要使用下面这个显示, Google search engine ,你可以使用:
- [http://www.google.com/ Google search engine]
这个格式。
Redirects - 页面转向
如果你需要自动把一个页面转向另一个,请使用 #REDIRECT 这个指令,同时把新转过去的网页名称放在括号內。
例如,你可以设定把 "Cats" 这个页面自动转向 "Cat" 。这样一来,不管使用者在搜索里面输入的是上面两个字的任一个,他们都会被转到 "Cat" 这个页面去。
Wiki 的变量 (variables) 和模板 (templates)
使用 {{SITENAME}} 这个指令来查看目前在编译的 wiki 文件名称。目前,在 ArchWiki 的网站內使用 {{SITENAME}} 将会以 ArchWiki 取代。
你也可以建立你自己的模板 (templates)。在建立一个新页面 Template:XXX 后,请使用 {{XXX}} 这个指令来把你的模板加入到你要修改的页面內。所以,如果你有许多网页需要加入相同的资料,试着使用模板的方法可以帮你省去许多麻烦。
讨论页面
讨论 (Discussion) 或是 "talk - 留言" 的页面主要是让你可以跟其他 Arch Wiki 的使用者有个对话的空间。
要讨论任何一个页面的內容时,请先选择你要的页面,然后点选页面上方的 "discussion" 这个分页。把你的留言加在讨论页面的最后面,或着加在你要回应的留言之后。
请为你的留言签个名,签名的方式可以用 ~~~~ 来加入你的帐号名称和时间标记。
请使用 indenting - 缩进 的功能来格式化你的讨论页面。比较标准的作法是,所有的回复都会依序比回应的原文往內缩一层。
现在让我们试着开始编辑 沙盒的留言页面 吧。
使用者留言页面
每个人都有个 user talk page (使用者留言页面),在这个页面上,每个人都可以写下公开的留言。如果某人签了个留言给你,你将会看到一个短讯,写着 "You have new messages",并包含一个链接直接连到你的使用者留言页面。
你可以选择在留言者自己的使用者留言页面上留言,或是在你自己的使用者留言页面上,跟贴在对方的留言之后。如果你选择留言在对方的留言页面上,对方将会在收到相同的通知短讯。
特殊分类
ArchWiki中有几个协助工作的特殊分类
尚未完成的文章
Category Stub这个分类包含了所有标记为{{stub}}(残缺)的文章。残缺的原因可能是:
- 篇幅太短
- 叙述不清
- 包含未完成部分
尚未翻译的文章
Category "Translation Requested"包含所有标记为{{translateme}}(待翻译)的文章。这个分类里的文章可能是因为:
- 有部分未翻译为对应的语言
- 内容尚未翻译,仅仅是简单的复制了其它语言的内容
- 源语言文章已经更新了,但翻译的页面部分丢失
包含隐藏错误或者混淆信息的文章
Category "Accuracy Disputes" 分类包含了所有标记为{{accuracy}}(准确性)标记的文章。这个分类里的文章有可能是:
- 带有显见的隐藏错误或者混淆信息,并且在相关页面的Talk:中讨论该如何修正
- 页面包含已作废/过期的信息,需要被更新
这个标记在Accuracy_dispute一文中有更详尽的描述
请求
想要求助吗?想要了解一些信息吗?写下你的请求吧!