說明:模板
模板是一段預先定義的 wikitext,可以直接插入到文章當中,主要用來加入格式化的內容。
本文描述並說明 Arch Wiki 的模板規則,關於中文 Wiki 的額外要求,請訪問 Help:翻譯.
使用[編輯 | 編輯原始碼]
要使用一個模板,在文章中加入如下內容:
{{Template name}}
大部分模板都可以附加額外參數,例如 Template:注意:
{{注意|这是一段应该注意的文字。}}
將顯示為:
有些模板使用帶名稱的參數,例如 Template:hc:
{{hc|head=/etc/rc.local|output=exit 0}}
將顯示為:
/etc/rc.local
exit 0
一般格式為:
{{Template name|param1|param2|...|paramN}}
每個模板的頁面都包含具體的使用方法。
樣式[編輯 | 編輯原始碼]
- 模板的大小寫應該與模板頁面的示例一致,例如應該使用
{{Pkg|...
和{{ic|...
而不是{{pkg|...
和{{Ic|...
。 - 模板名的前後不應該有空格,: 應該用
{{Template name|...
而不是{{ Template name |...
。 - 不應對模板進行分類。
轉義特殊字符[編輯 | 編輯原始碼]
有些字符在模板中使用會擾亂輸出,常見的如 "=" (等號) 和 "|" (管道字符). 可以用下面方法處理:
- 管道字符 "|" 可以通過 magic word
{{!}}
顯示。 - 等號 "=" 可以通過 magic word
{{=}}
顯示。
使用命名和位置編號參數[編輯 | 編輯原始碼]
如果問題是 = 引起,可以通過命名或位置編號參數解決。
例如:{{Tip|1=https://archlinux.org/?foo=bar}}
顯示為:
此方法非常適合這些情況使用:
- 變量定義
- URL中帶有查詢參數的站外連結
- 命令行字符串和命令
- 多行代碼
參數前後的多個空行會被自動移除,要保留空白支付,請使用 <nowiki/>
標籤。
例如:
{{Tip|1=<nowiki/> * https://archlinux.org/?foo=bar * https://archlinux.org/?foo=baz }}
將顯示為:
多個參數[編輯 | 編輯原始碼]
- 使用位置編號參數
1
和2
{{hc|1=$ echo "="|2==}}
效果:
$ echo "="
=
- 使用命名參數
head
和output
{{hc|head=$ echo "="|output==}}
效果:
$ echo "="
=
nowiki 標籤[編輯 | 編輯原始碼]
如果要支持 = 之外的字符,例如 "}", 請用 <nowiki>
包裹完整參數,但是這時他所有 Wiki 語法都會失效,例如連結和其他模板等都只會顯示原始文本。示例:
{{Tip|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}
當然,在 <nowiki>
標籤中只包含特定部分(甚至單個字符)仍然有效,但為了可讀性,建議只在連結或其他模板必須正常顯示時才使用這種方法。例如:
{{Tip|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}
foo
將字符替換為 HTML 實體[編輯 | 編輯原始碼]
此方法支持所有字符,但是不利於後續維護,所以僅當上面方法不適用時再使用。示例:
{{Tip|= | {{ }}}}
創建[編輯 | 編輯原始碼]
- 模板命名空間是半保護的。只有自動確認的用戶才能創建或編輯模板。
- 創建新模板前先在幫助討論:模板 進行討論。
- 請僅創建多次使用的模板。如果某個特殊的模板僅在有限的幾個文章中使用,請不要創建它。
- 請創建精簡的模板,不要忘了 Arch 之道: 大道至簡!
創建模板時,在本中文維基中,模板和模板的文檔是分開創建的。模板頁面的內容像這樣:
<includeonly>此处是模板代码...</includeonly><noinclude>{{documentation}} <!-- 请将分类/语言链接放在文档页面 --></noinclude>
模板文檔應該位於模板的/doc
子頁面。模板內通過 noinclude 標籤調用{{Documentation}}
後,(預覽或者保存後)按模板上的「創建」連結會自動加載所需的文檔模板。詳情參見模板:模板。
要開始創建過程,請先訪問 Template:Template name
(將Template name
替換為要創建的模板名), 然後幫助:編輯添加相關內容。
<includeonly>
和 <noinclude>
標籤之外的文本也會出現在模板調用的結果中。<includeonly>
的意思僅僅是不要在模板自己的頁面中出現。因此,不要在開始標籤前、結束標籤後換行,以避免額外的空行出現在使用模板的頁面中。模板列表[編輯 | 編輯原始碼]
下列模板可直接於ArchWiki的頁面中使用。點擊連結可以查看詳細使用方法。完整列表位於Special:AllPages/Template:、Special:PrefixIndex/Template:或Special:MostLinkedTemplates。
沙盒[編輯 | 編輯原始碼]
文章狀態模板[編輯 | 編輯原始碼]
請將下列模板加入文章或段落的開頭,詳情參閱 Help:風格#文章狀態模板.
譯者還應檢查 ArchWiki:Translation Team 中的模板指南。
下列模板都通過 Wiki 維護分類統一管理,ArchWiki:Statistics#Maintenance statistics 包含相關模板使用情況的統計。
名稱 | 適用情形 | 參數 |
---|---|---|
Template:Style | 內容存在語句、wiki 語法或樣式問題. | 1 — 原因, 2 — 討論頁面(可選), section — 討論話題(可選)
|
Template:Accuracy | 不正確、錯誤或容易引起誤解的內容. | |
Template:Expansion | 不全的內容. | |
Template:Out of date | 已經過時的內容. | |
Template:Remove | 不相關、無幫助內容. | |
Template:Archive | 已經過時的頁面. | |
Template:Laptop style | Laptop pages not following the Help:Laptop page guidelines|Laptop page guidelines. | |
Template:Translateme | 翻譯不完全的內容. | |
Template:Bad translation | 有問題的翻譯 | |
Template:TranslationStatus | 翻譯狀態 | 1 — 英文頁面標題, 2 — 翻譯日期, 3 — 英文頁面版本號
|
Template:Merge | 文章內容和其他頁面重疊 | 1 — 目標頁面, 2 — 原因, 3 — 討論頁面(可選), section — 討論話題(可選)
|
Template:Move | 文章應該改名. | |
Template:Redirect | 文章應該重定向到其它頁面. | |
Template:Unsupported | 和 Arch Linux 無關的用戶頁面. | 1 — 最後審閱的日期
|
用於非英語頁面:
- Template:Bad translation
- Template:Translateme (簡體中文) (模板:需要翻譯)
- Template:TranslationStatus (簡體中文) (Template:翻譯狀態)
相關文章模板[編輯 | 編輯原始碼]
代碼排版模板[編輯 | 編輯原始碼]
提示模板[編輯 | 編輯原始碼]
- Template:Note (簡體中文) (Template:注意)
- Template:Tip (簡體中文) (Template:提示)
- Template:Warning (簡體中文) (Template:警告)
僅用於討論頁的草稿:
雜項[編輯 | 編輯原始碼]
- Template:App
- Template:Broken package link
- Template:Broken section link
- Template:Bug
- Template:Committed identity
- Template:Dead link
- Template:Lowercase title
- Template:man
- Template:Unsigned
軟體包模板[編輯 | 編輯原始碼]
表格模板[編輯 | 編輯原始碼]
文字對齊:
模板名 | 對齊 | Wiki標記 | 效果 |
---|---|---|---|
Template:C | 居中 | {{C|text}} |
text |
Template:L | 靠左 | {{L|text}} |
text |
單元格背景:
模板名 | 顏色 | Wiki標記 | 效果 |
---|---|---|---|
Template:R | red | {{R|text}} |
text |
Template:O | orange | {{O|text}} |
text |
Template:Y | yellow | {{Y|text}} |
text |
Template:G | green | {{G|text}} |
text |
Template:B | blue | {{B|text}} |
text |
Template:V | violet | {{V|text}} |
text |
Template:Grey | grey | {{Grey|text}} |
text |
常見文字:
模板名 | Wiki標記 | 效果 |
---|---|---|
Template:是 | {{是}} |
是 |
{{是|https://wiki.archlinux.org/}} |
是 | |
Template:否 | {{否}} |
否 |
{{否|https://wiki.archlinux.org/}} |
否 | |
Template:- | {{-}} |
– |
| colspan=2 {{是}}
。