Help:Template (简体中文)

From ArchWiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

相关文章

翻译状态：本文是 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 {{是}}。

分类模版

参见