Help:Template (简体中文)

From ArchWiki

相关文章

翻译状态：本文是 Help:Template 的翻译。上次翻译日期：2019-01-17。如果英文版本有所更改，则您可以帮助同步翻译。

模板是一段预先定义的 wikitext，可以直接插入到文章当中，主要用来加入格式化的内容。

使用

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

{{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.

使用命名和位置编号参数

如果问题是 = 引起，比如 URL 地址中，可以通过命名或位置编号参数解决。例如 

{{Tip|1=https://www.archlinux.org/?foo=bar}}

显示为：

提示： https://archlinux.org/?foo=bar

此方法非常适合这些情况使用：

  • 变量定义
  • 命令行字符串和命令
  • 多行代码
多个参数
  • 使用位置编号参数1和2 
{{hc|1=$ echo "="|2==}}

效果：

$ echo "="
=
  • 使用命名参数head和output 
{{hc|head=$ echo "="|output==}}

效果：

$ echo "="
=

用 nowiki

此方法支持所有字符 ( = | }} )，但是其他格式也都不会显示，例如链接和其他模板。 

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

将字符替换为 HTML 语法

此方法支持所有字符，但是不利于后续维护，所以仅当上面方法不适用时再使用。 

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

创建

注意：
  • 创建新模版前先在 Help talk:Template 进行讨论.
  • 请仅创建多次使用的模板。如果某个特殊的模板仅在有限的几个文章中使用，请不要创建它。
  • 请创建精简的模板，不要忘了 Arch 之道: 大道至简！

创建模板时可以用下面的模板简化使用和编辑： 

<noinclude>{{Template}}

'''模板简介'''

====用法====

{{ic|<nowiki>{{Template name|param1|param2|...|paramN}}</nowiki>}}

====示例====

{{Template name|param1|param2|...|paramN}}</noinclude><includeonly>此处是模板代码...</includeonly>

要开始创建过程，请先访问 Template:Template name (将Template name替换为要创建的模板名), 然后编辑添加相关内容。

模板列表

下列模版可直接于ArchWiki的页面中使用。点击链接可以查看详细使用方法。完整列表位于Special:AllPages/Template:、Special:PrefixIndex/Template:或Special:MostLinkedTemplates。

沙盒

警告： 请不要直接修改已经存在的模板。如果需要编辑未保护的模板，请将内容复制到Template:Sandbox进行编辑和测试，正常工作后再复制回去。强烈推荐（受保护模版必须）先在讨论页提出修改建议。

文章状态模板

用于所有语言页面：

用于非英语页面：

对于过时的页面：

注意： 挂有文章状态模板的页面信息显示在对应维护分类和ArchWiki:Statistics#Maintenance statistics中。

相关文章模版

代码排版模版

提示模版

仅用于讨论页的草稿：

杂项

软件包模板

表格模版

文字对齐：

模版名 对齐 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 {{是}}。

分类模版

参见