說明:模板 - Arch Linux 中文维基

跳至內容

# 說明:模板

出自 Arch Linux 中文维基
翻譯狀態：

- 本文（或部分內容）譯自 Help:Template，最近一次同步於 2023-01-06，若英文版本有所更改，則您可以幫助同步與翻譯更改的內容。
- 您可以在 ArchWiki 的對應頁面找到本文翻譯的原始修訂歷史。
- 本文可能與英文原文存在出入。

相關文章

- 幫助:編輯
- 幫助:閱讀
- 幫助:風格

模板是一段預先定義的 wikitext，可以直接插入到文章當中，主要用來加入格式化的內容。

本文描述並說明 Arch Wiki 的模板規則，關於中文 Wiki 的額外要求，請訪問 Help:翻譯.

## 使用

要使用一個模板，在文章中加入如下內容:

    {{模板名称}}

大部分模板都可以附加額外參數，例如 Template:注意:

    {{注意|这是一段应该注意的文字。}}

將顯示為:

注意：這是一段應該注意的文字。

有些模板使用帶名稱的參數，例如模板:hc:

    {{hc|head=/etc/rc.local|output=exit 0}}

將顯示為:

    /etc/rc.local

    exit 0

一般格式為:

    {{模板名称|参数1|参数m2|...|参数N}}

每個模板的頁面都包含具體的使用方法。

### 樣式

- 模板的大小寫應該與模板頁面的示例一致，例如應該使用 `{{Pkg|...` 和 `{{ic|...` 而不是 `{{pkg|...` 和 `{{Ic|...`。
- 模板名的前後不應該有空格，: 應該用`{{模板名稱|...` 而不是 `{{ 模板名稱 |...`。
- 不應對模板進行分類。

### 轉義特殊字符

有些字符在模板中使用會擾亂輸出，常見的如 "=" (等號) 和 "|" (管道字符). 可以用下面方法處理：

提示：

- 管道字符 "|" 可以通過 magic word `{{!}}` 顯示。
- 等號 "=" 可以通過 magic word `{{=}}` 顯示。

#### 使用命名和位置編號參數

如果問題是 = 引起，可以通過命名或位置編號參數解決。 例如：`{{提示|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
    }}

將顯示為:

提示：

- 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 語法都會失效，例如連結和其他模板等都只會顯示原始文本。示例：

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

提示：= | }} https://archlinux.org/ {{ic|foo}}

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

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

提示：= | }} https://archlinux.org/ `foo`

#### 將字符替換為 HTML 實體

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

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

提示：= | {{ }}

## 創建

注意：

- 模板命名空間是半保護的。只有自動確認的用戶才能創建或編輯模板。
- 創建新模板前先在幫助討論:模板 進行討論。
- 請僅創建多次使用的模板。如果某個特殊的模板僅在有限的幾個文章中使用，請不要創建它。
- 請創建精簡的模板，不要忘了 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。

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

### 沙盒

- Template:Sandbox
- Template:Lorem Ipsum

### 文章狀態模板

請將下列模板加入文章或段落的開頭，詳情參閱 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:Related articles start
- Template:Related
- Template:Related articles end

### 代碼排版模板

- Template:ic
- Template:bc
- Template:hc
- Template:hsc
- Template:Text art

### 提示模板

- Template:Note (簡體中文) （Template:注意）
- Template:Tip (簡體中文) （Template:提示）
- Template:Warning (簡體中文) （Template:警告）

僅用於討論頁的草稿：

- Template:Comment

### 雜項

- 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

### 軟體包模板

- Template:Pkg
- Template:Grp
- Template:AUR
- Template:Cnrepo

### 表格模板

文字對齊：

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

### 分類模板

- Template:Cat main

## 參見

- Template:Template
- MetaWikimedia:Help:Template/zh

分類：​

- 幫助

說明:模板
新增話題