說明:編輯

出自 Arch Linux 中文维基

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:製作機械人