說明:模板

出自 Arch Linux 中文维基

相關文章

模板是一段預先定義的 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}}

顯示為：

提示：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>}}
提示：= | }} https://archlinux.org/ {{ic|foo}}

當然，在 <nowiki> 標籤中只包含特定部分(甚至單個字符)仍然有效，但為了可讀性，建議只在鏈接或其他模板必須正常顯示時才使用這種方法。例如: 

{{Tip|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}
提示：= | }} https://archlinux.org/ foo

將字符替換為 HTML 實體[編輯 | 編輯原始碼]

此方法支持所有字符，但是不利於後續維護，所以僅當上面方法不適用時再使用。示例： 

{{Tip|&#61; &#124; &#123;&#123; &#125;&#125;}}
提示：= | {{ }}

創建[編輯 | 編輯原始碼]

注意：

創建模板時，在本中文維基中，模板和模板的文檔是分開創建的。模板頁面的內容像這樣： 

<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。

警告： 請不要直接修改已經存在的模板。如果需要編輯未保護的模板，請將內容複製到Template:Sandbox進行編輯和測試，正常工作後再複製回去。強烈推薦（受保護模板必須）先在討論頁提出修改建議。

沙盒[編輯 | 編輯原始碼]

文章狀態模板[編輯 | 編輯原始碼]

請將下列模板加入文章或段落的開頭，詳情參閱 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 — 最後審閱的日期

用於非英語頁面：

相關文章模板[編輯 | 編輯原始碼]

代碼排版模板[編輯 | 編輯原始碼]

提示模板[編輯 | 編輯原始碼]

僅用於討論頁的草稿：

雜項[編輯 | 編輯原始碼]

軟件包模板[編輯 | 編輯原始碼]

表格模板[編輯 | 編輯原始碼]

文字對齊：

模板名 對齊 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 {{是}}。

分類模板[編輯 | 編輯原始碼]

參見[編輯 | 編輯原始碼]

取自「https://wiki.archlinuxcn.org/wzh/index.php?title=Help:模板&oldid=26004」