View source for Help:Zh/Templates

{{LanguageBar|title = 帮助：模板}}
{{Subpage| {{LHelp|Contents}} }}

{{Help page}}

{{ACategory|Wiki}}


{{:User:1416006136/Signature|time=4:50 May 11 2024}}
{{Cleanup}}
'''模板'''是一个创建用于包含在其他页面中的维基页面。模板通常包含可能需要在大量文章或页面上显示的重复性材料。它们通常用于样板消息、标准化警告或通知、信息框、导航框以及类似目的。

它们使您能够更快速和/或更容易地完成事情。模板在页面上非常频繁地使用，因此最好了解它们。当维基看到它在页面上识别的模板时，它会自动将其替换为其他内容。那里出现的内容取决于用户。

==如何使用模板==
要向页面添加模板（称为''转录''），只需键入{{Code|{{((}}}}，模板的名称，然后{{Code|{{))}}}}。
如果您希望添加任何参数，请在模板名称和{{Code|{{))}}}}之间放置一个{{Code|{{!}}}}，并在那里定义参数。您定义的所有参数都需要由另一个{{Code|{{!}}}}分隔。

{{Note|实际上，任何页面都可以被另一个页面转录。可以使用{{tlc|<nowiki>:</nowiki>Main Page}}转录{{L|Main Page}}，但我们在这里不这样做，因为它会将Main Page的所有标题添加到本页面的目录中。}}

=== 示例 ===
这是一个我们没有定义任何参数的模板。预览时，表达式{{tlc|restart}}（或{{tlc|Restart}}）将被[[Template:Restart]]页面的内容替换。如果您访问它，您会看到它只包含那五个单词。
:{{tlc|restart}} → {{restart}}

{{Note|下面是一个关于{{Command|sv_cheats}}控制台命令的示例，这是错误的，因为它不是一个实体。请对控制台命令使用{{tl|Command}}。}}

{{tl|Ent}}可以接受多达两个''未命名''参数。如其页面所述，该模板的工作方式是，它会以等宽字体显示第一个参数的值，并使其成为一个维基链接。假设我们想要一个指向{{L|sv_cheats}}的代码风格链接；要使用此模板，我们键入<tt>{{((}}</tt>，然后是模板名称，即<tt>ent</tt>或<tt>Ent</tt>，然后对于第一个参数，我们键入一个管道符号和值<tt>sv_cheats</tt>。如果我们愿意，我们还可以指定第二个参数，该参数（如模板所指定）也将以代码风格显示，但不作为链接。未命名参数的顺序很重要。如果我们没有指定参数，模板就不会按预期工作。
:{{tlc|ent|sv_cheats}} → {{ent|sv_cheats}}
:{{tlc|ent|sv_cheats|1}} → {{ent|sv_cheats|1}}
:{{tlc|ent}} → {{ent}}

[[Template:KV]]是用于显示实体类keyvalue信息的最常见模板之一。它接受多个可选的''命名''参数，例如<code>only</code>和<code>nofgd</code>。要为这些指定值，我们需要键入参数的名称、等号，然后是值。命名参数可以以任何顺序定义。请注意，我们可以同时指定未命名和命名参数。在以下示例中，我们有三个未命名参数（<tt>ammo, integer</tt>和最后一个）和两个命名参数（<tt>only={{css}}</tt>和<tt>nofgd=1</tt>）。
:{|
| {{tlc|KV|only{{=}}{{css}}|ammo|nofgd{{=}}1|integer|要添加的备用弹药量。默认值为0。}}
|-
| ↓
|-
| {{KV|only={{css}}|ammo|nofgd=1|integer|要添加的备用弹药量。默认值为0。}}
|}

如果没有<code>|nofgd=1</code>，<strong>{{!fgd}}</strong>部分就不会显示。
{{note|未命名参数可以像命名参数一样以任何顺序指定，例如：{{tlc|ent|2{{=}}1|1{{=}}sv_cheats}} → {{ent|2=1|1=sv_cheats}}。事实上，未命名参数确实有一个可以定义的名称，即它们的参数''编号''。这样，人们也可以例如指定第三个参数，但不是第一个和第二个。}}
{{note|调用模板时，您总是可以指定任意数量的命名和未命名参数。唯一的问题是模板是否考虑它们，产生不同的结果或相同的结果。顺便说一下，多次指定一个参数会在页面顶部显示一个错误。}}

模板也可以使用模板，称为嵌套。不支持[[w:Recursion (computer science)|递归]]，因此模板不能使用自己。

=== 替换 ===
这是给高级用户的。与其转录模板，不如选择''替换''它。替换将用模板的内容''替换''模板调用的维基文本。
不要轻率地替换，因为替换后的维基文本在模板更新时不会更新。有关更多信息，请参见[[Wikipedia:Help:Substitution]]。

要替换模板，请像通常一样转录它，然后在<code>{{</code>和模板名称之间添加<code>subst:</code>。之后，点击保存按钮，维基文本将自动添加。

例如，如果您在页面上写下{{tlc|restart}}，保存它，然后再次编辑页面，您仍会在维基文本中的同一位置找到{{tlc|restart}}。相比之下，如果您保存{{tlc|subst:restart}}然后再次编辑页面，您会发现<code>需要重启才能生效。</code>。可以想象维基是“复制粘贴”内容过来的，但它确实考虑了参数值：
:{{tlc|subst:delete|这是一个糟糕的页面。}}
如果页面保存了这个，那么文本将被[[Template:Delete]]的内容替换，其中每次出现{{Param}}都被替换为<code>这是一个糟糕的页面。</code>：
:<code><nowiki>{{Delete-meta|{{#if: 这是一个糟糕的页面。 | 这是一个糟糕的页面。 }} }}{{ACategory|Candidates for speedy deletion}}</nowiki></code>
注意参数的自动转发。替换时，页面的外观不应与转录时有任何不同。唯一的区别在于页面代码。
{{tip|编辑时，请务必在保存替换之前使用'''查看更改'''，以查看您实际对维基文本做了什么。}}

==制作模板==
在模板可以添加到某处之前，首先必须在其自己的页面上定义其内容。模板页面以前缀<code>Template:</code>开头。另请参阅：{{LHelp|Page Creation}}。

制作像[[Template:Restart]]这样的模板相当容易：在右上角的搜索栏中输入<tt>Template:Restart</tt>，单击其红色链接（假设页面尚不存在），输入您想要的文本，然后保存。之后，这个新模板就可以像上面描述的那样使用了。
{{tip|在制作模板时，您可能希望将代码分开以使其更易于阅读，但要注意不要意外添加空白，尤其是换行符。HTML注释（<code><nowiki><!-- --></nowiki></code>）也可能会有用。}}
{{note|命名参数（例如{{Param|title}}）在模板结果中将删除前导和尾随空白，未命名参数（例如{{Param}}）则不会。}}

===未命名参数===
要添加未命名参数，只需在想要第一个未命名参数值的位置放置{{Param}}。
这是[[Template:Tip]]代码的一部分：
:<code>提示:{{Param}}</code>
如果您以前见过这个模板，就会知道它有自己特殊的外观，但目前我们只看这些内容。当传递此内容时，用户只需输入他们想要的文本：
:{|
| {{tlc|tip|不要在之后没有顶点编辑的情况下进行雕刻。}}
|-
| ↓
|-
| {{tip|不要在之后没有顶点编辑的情况下进行雕刻。}}
|}
如果要添加多个未命名参数，只需更改数字。这是[[Template:Distinguish]]的旧（压缩的）代码。此模板有一些我们尚未讨论的内容，但您仍然可以看到有四个未命名参数被使用：{{Param}}、{{Param|2}}、{{Param|3}} 和 {{Param|4}}。
<pre style="background-color:#444;border-color:#666;color:#ddd">:''请勿与{{L|{{{1}}}}}混淆{{#if:{{{2|}}} |{{#if:{{{3|}}} |，{{L|{{{2}}}}}| 或 {{L|{{{2}}}}}。}}。{{#if:{{{3|}}} |{{#if:{{{4|}}} |，{{L|{{{3}}}}}|，或 {{L|{{{3}}}}}。}}。{{#if:{{{4|}}} |，或 {{L|{{{4}}}}}。}}''</pre>

当传递内容时，用户只需这样做：
:{|
| {{tlc|distinguish|Combine|Civil Protection|Overwatch}}
|-
| ↓
|-
| {{distinguish|Combine|Civil Protection|Overwatch}}
|}

===命名参数===
通常，您希望只有在传递时定义了命名参数时才会影响任何内容。我们将在后面讨论条件。现在，让我们看一下[[Template:IO]]，它有许多命名参数。在此模板中，{{Param|param}}标记了在传递时由<code>|param=texthere</code>定义的wikitext的位置。

使用命名参数：
:{|
| {{tlc|IO|SetString|更新字符串。|param{{=}}string}}
|-
| ↓
|-
| {{IO|SetString|更新字符串。|param=string}}
|}

不使用命名参数：
:{|
| {{tlc|IO|SetString|更新字符串。}}
|-
| ↓
|-
| {{IO|SetString|更新字符串。}}
|}

===默认值===
要使参数默认具有值，请在参数名称右侧添加<code>|</code>，然后定义默认值。命名参数和未命名参数都可以使用这个功能。

如果用户不指定，这会将{{Param}}的值设为3000。
{{CodeBlock|{{Param||3000}}}}


如果用户没有指定<code>|value=...</code>，则返回空字符串。请注意{{param|value}}和{{param|value|}}之间的区别。前者如果用户不定义它，将直接返回文本<code>{{{value}}}</code>。
{{CodeBlock|{{Param|value|}}}}

{{Note|为参数指定默认值仅适用于该参数的特定出现。如果有多个{{Param}}的出现，所有这些都应该具有默认值<tt>0</tt>，则必须为所有这些输入{{param||0}}。另一方面，如果合适的话，这也允许您在不同的出现中使用不同的默认值。}}

===解析器函数===
要使文本（不）在仅在某个参数被定义或设置为特定值时出现，以下表达式是适用的。

解析器函数<code>#if:</code>检查字符串是否为空。语法是<code><nowiki>{{#if: <string> | <then> | <else> }}</nowiki></code>。如果<code><string></code>不是空字符串，则此表达式评估为<code><then></code>，否则为<code><else></code>。如果不指定<code><else></code>值，则默认为空字符串；以下<code><else></code>同样适用。
:<code><nowiki>{{#if: &nbsp; | 非空 | 空 }}</nowiki></code> &rarr; {{#if:   | 非空 | 空 }}
:<code><nowiki>{{#if: X      | 非空 | 空 }}</nowiki></code> &rarr; {{#if: X | 非空 | 空 }}
:<code><nowiki>{{#if: &nbsp; | 非空 }}</nowiki></code> &rarr; {{#if:   | 非空 }}
:<code><nowiki>{{#if: X      | 非空 }}</nowiki></code> &rarr; {{#if: X | 非空 }}
:<code><nowiki>{{#if: {{{target|}}} | 已获取目标 | 休眠模式已激活... }}</nowiki></code> &rarr; {{#if: {{{target|}}} | 已获取目标 | 休眠模式已激活... }}
:<code><nowiki>{{#if: 文字存在！ | 已获取目标 | 休眠模式已激活... }}</nowiki></code> &rarr; {{#if: 文字存在！ | 已获取目标 | 休眠模式已激活... }}
{{note|''表达式<code><nowiki>{{{target|}}}</nowiki></code>返回空字符串，因为您（可能）没有通过转录查看此页面，因此它从未有过定义的机会，因此返回其默认值为空字符串。''}}

<code>#ifeq:</code>检查两个字符串是否相等。语法是<code><nowiki>{{#ifeq: <string1> | <string2> | <then> | <else> }}</nowiki></code>。如果两个（修剪后的）字符串完全相等，则评估为<code><then></code>，否则为<code><else></code>。
:<code><nowiki>{{#ifeq: X | X | 相等 | 不相等 }}</nowiki></code> &rarr; {{#ifeq: X | X | 相等 | 不相等 }}
:<code><nowiki>{{#ifeq: X | Y | 相等 | 不相等 }}</nowiki></code> &rarr; {{#ifeq: X | Y | 相等 | 不相等 }}
:<code><nowiki>{{#ifeq: {{{target|}}} | friend | 朋友... | 走开！ }}</nowiki></code> &rarr; {{#ifeq: {{{target|}}} | friend | 朋友... | 走开！ }}
:<code><nowiki>{{#ifeq: friend | friend | 朋友... | 走开！ }}</nowiki></code> &rarr; {{#ifeq: friend | friend | 朋友... | 走开！ }}

<code>#switch:</code>检查输入字符串与''多个''字符串之间的等式。语法是
<code><nowiki>{{#switch: <input> | <string1> = <value1> | <string2> = <value2> | ... | #default = <default> }}</nowiki></code>。
此语句将评估为第一个<code><stringX></code>等于<code><input></code>的相应<code><valueX></code>。如果<code><stringX></code>没有跟随等号，因此没有<code><valueX></code>，则使用下一个具有等号的<code><stringY></code>的<code><valueY></code>。如果找不到等式，则返回<code><default></code>，如果未指定，则默认为空字符串。

<code>#expr:</code>解决数学问题。请参阅[[m:Help:Calculation|Help:Calculation]]以获取其所有功能。如果发生错误，则返回{{code|1=&lt;strong class="error">}}元素中的字符串。
:<code><nowiki>{{#expr: 2 + 2}}</nowiki></code> &rarr; {{#expr: 2 + 2}}
:<code><nowiki>{{#expr: cos(pi/3)^2}}</nowiki></code> &rarr; {{#expr: cos(pi/3)^2}}
:<code><nowiki>{{#expr: 0 and 1 or 1}}</nowiki></code> &rarr; {{#expr: 0 and 1 or 1}}
:<code><nowiki>{{#expr: 1 + }}</nowiki></code> &rarr; {{#expr: 1 + }}
:<code><nowiki>{{#ifeq: {{#expr: 1 + }} | 1 | 真 | 假}}</nowiki></code> &rarr; {{#ifeq: {{#expr: 1 + }} | 1 | 真 | 假}}

<code>#ifexpr:</code>测试数学表达式是真还是假，并根据其返回不同的值。
:<code><nowiki>{{#ifexpr: 6 + 3 = &nbsp;9 | 正确 | 错误 }}</nowiki></code> &rarr; {{#ifexpr: 6 + 3 =  9 | 正确 | 错误 }}
:<code><nowiki>{{#ifexpr: 6 + 3 = 63      | 正确 | 错误 }}</nowiki></code> &rarr; {{#ifexpr: 6 + 3 = 63 | 正确 | 错误 }}
{{Warning|offset=1|将参数传递给表达式时，要注意如果参数为空会导致错误。例如，如果整数参数在被留空时应该像0一样行为，则添加一个小数点，因为{{code|.}}会被转换为与{{code|0.}}相

同的零。<br>
例如，使用{{code|{{param|hl2|0}}.}}而不是{{code|{{param|hl2|0}}}}，因为如果指定了{{code|1=hl2=}}，后者可能会失败：
:<code><nowiki>{{#ifexpr: 1 or .      | 真 | 假}}</nowiki></code> &rarr; {{#ifexpr: 1 or . | 真 | 假}}
:<code><nowiki>{{#ifexpr: 1 or &nbsp; | 真 | 假}}</nowiki></code> &rarr; {{#ifexpr: 1 or   | 真 | 假}}
}}

<code>lc:</code>和<code>uc:</code>将字符串转换为小写或大写。请注意，与<code>#if:</code>等不同，这些没有哈希标记。
还有<code>lcfirst:</code>和<code>ucfirst:</code>，它们仅操作表达式的第一个字符。
:{{tlc|lc:Case Sensitivity}} &rarr; {{lc:Case Sensitivity}}
:{{tlc|uc:Case Sensitivity}} &rarr; {{uc:Case Sensitivity}}
:{{tlc|lcfirst:Case Sensitivity}} &rarr; {{lcfirst:Case Sensitivity}}

{{Seealso|[[mw:Help:Extension:ParserFunctions|Help:Extension:ParserFunctions]]}}

===文档===
请描述您的模板所做的事情，特别是提供示例。为了使页面上不使用模板的描述文本，或使模板页面本身看起来更整洁，您可以使用三种不同的HTML标签。
* <code>&lt;noinclude>...&lt;/noinclude></code> 防止wikitext被传递到其他页面。它仅会显示在模板的页面上。
* <code>&lt;onlyinclude>...&lt;/onlyinclude></code> 使其中的wikitext仅出现在目标页面上。其他所有内容都不会被传递，但仍将出现在模板的页面上。
* <code>&lt;includeonly>...&lt;/includeonly></code> 防止其中的wikitext出现在模板的页面上。它不会对目标页面产生影响。

因此，您可以使用<code>&lt;onlyinclude></code>将应该传递的所有内容包围起来，或者将其他所有内容都包围在<code>&lt;noinclude></code>中。此外，您可以使用<code>&lt;includeonly></code>在模板页面上隐藏模板文本。
这些标签起初可能听起来很令人困惑。如果您不确定如何使用它们，请检查模板的源代码，因为几乎所有模板都以某种方式使用它们。

如果文档不能保持简短，那么将所有解释和/或示例移至单独的页面是一个好主意。按照惯例，模板的文档页面应为其子页面<code>/doc</code>。例如，[[Template:Note]]有其文档页面[[Template:Note/doc]]。创建后，文档将使用表达式{{tl2|doc}}传递到模板页面，当然，必须使用上述标签排除它。

有时，模板的使用方式是相同的。您可能知道，[[Template:Tip]]和[[Template:Note]]都以完全相同的方式使用其一个参数，因此无需另一个具有相同文档的页面来描述Tip。Tip可以使用与Note相同的文档，使用表达式{{tlc|documentation|Template:Note/doc}}；这背后的唯一魔法是Template:Note/doc使用表达式{{tlc|ROOTPAGENAME}}而不是<code>Note</code>用于其示例，以便示例适应其显示的页面。如果Template:Note/doc不是为此而制作的，那么这将行不通。
其他像这样使用的“通用文档”包括[[Template:Hl2]]和[[Template:Yes]]。

===模板未更新===
如果您最近编辑了一个模板，但更改未应用到已经转录到的页面上，请在这些页面的URL末尾添加<code>?action=purge</code>。这将告诉服务器立即更新页面的HTML。您也可以通过编辑页面并保存而不进行任何更改来实现相同的效果。
如果您在具有文档的模板页面上，您还可以使用相同效果的“[刷新]”按钮。

===模板快捷方式===
一些模板可能具有模板[[Template:shortcut|快捷方式]]，这些是重定向，是目标模板的缩写或其他不同形式。模板快捷方式可以像其目标模板一样转录。

===翻译===
模板应包含翻译，以便以其他语言为母语的人更容易理解模板的内容。有两种方法可以实现这一点。

====方法二：字符串子页面====
较大的模板（例如{{tl|link=Software page}}）往往具有大量文本，在一个页面上将它们全部放在一起会使其显得杂乱无章且很难编辑。为了解决这个问题，几乎所有这些模板上的文本都放在了一个字符串子页面（例如{{tl|link=Software page/strings}}）上，当指定特定字符串时，它将呈现相应的翻译文本。这不仅有助于文本编辑，还有助于翻译，因为编辑者不必在大量代码中寻找他们想要编辑/翻译的小文本。然而，对于较小的模板来说，这可能会非常复杂，因此通常只用于较大的模板。

{{Tip|您可能会看到一些模板仍在使用旧的后缀翻译方法。请注意，这不再是首选方法，如果您知道如何操作，应该更新为使用当前的方法。}}

==有用的模板==

所有以'''{{style|color:#8BC53F|绿色文本}}'''显示的模板都是该颜色，以便与大多数页面的灰度色调形成对比。大多数具有该颜色的模板还会自动将其转录到的页面添加到{{LCategory|TODO}}。

===按游戏分类的模板===

所有游戏都有以其快捷方式命名的模板，可以提供其关联图标和/或链接到其页面的链接。请参阅{{LCategory|Game icons}}以获取游戏快捷方式的完整列表。它们都接受每个模板页面上描述的相同一组参数。以下表格应该给出示例，同时也给出了何时使用它们的想法。
{| class="wikitable mw-collapsible" width=100% style=background-color:transparent
! Wikitext
!colspan=3| 示例
! 描述
! 以前使用的模板/替代品
|-
| {{tlc|<shortcut>}} || {{tl2|hl2}}||→||{{hl2}} || 显示游戏的图标，链接到其游戏页面，并将游戏名称显示为悬停文本。将其放在单词或行的开头（或结尾）是澄清仅适用于特定游戏的最简短和最常见的方式，但还有其他更多的方法。||
|-
| {{tlc|<shortcut>|2}} || {{tlc|hl2|2}}||→||{{hl2|2}} || 显示游戏的图标，后跟其名称，两者都链接到游戏页面。在句子中使用时，仅图标太小，但下一个样式太多时，此项非常有用。|| {{tl2|game link}} {{deprecated}}
|-
| {{tlc|<shortcut>|4}} || {{tlc|hl2|4}}||→||{{hl2|4}} || 使用色彩丰富的文本执行相同操作，引起更多关注，因此不要在页面上过度使用此功能。特别是如果在文本中多次命名同一款游戏，那么绝对不需要每次都是一个长而且有色彩的链接，更不要说链接了。|| {{tl2|game name}} {{deprecated}}
|-
| {{tlc|<shortcut>|in}} || {{tlc|hl2|in}} ||→|| {{hl2|in}} || 可用于指示某些内容适用于特定游戏。在行尾或关键字处使用时很有用；后续变体也是如此。|| {{tl2|in}}
|-
| {{tlc|<shortcut>|since}} || {{tlc|portal2|since}} ||→|| {{portal2|since}} || 可用于快速注明添加在游戏中并在之后所有Source游戏中可用的功能。|| {{tl2|since}}
|-
| {{tlc|<shortcut>|only}} || {{tlc|csgo|only}} ||→|| {{csgo|only}} || 表示仅适用于特定游戏的功能。|| {{tl2|only}}
|-
| {{tlc|<shortcut>|also}} || {{tlc|as|since}}&nbsp;{{tlc|gmod|also}} ||→|| {{as|since}}&nbsp;{{gmod|also}} || 指出较早的游戏也具有一个功能，通常是从较新的引擎分支中移植过来的。这些应与另一个游戏通知模板一起使用。|| {{tl2|also}}
|-
| {{tlc|<shortcut>|removed}} || {{tlc|l4d|removed}} ||→|| {{l4d|removed}} || 表示某个功能在游戏中被移除，以及之后的所有引擎分支。|| {{tl2|removed}}
|-
| {{tlc|<shortcut>|not}} || {{tlc|czds|not}} ||→|| {{czds|not}} || 表示某个功能可能在其他游戏中，但在特定游戏中不存在。|| {{tl2|not}}
|}

=== 内联注释模板 ===

以下是一些{{LCategory|inline note templates|内联注释模板}}。
{| class="wikitable mw-collapsible" width=100% style=background-color:transparent
! 描述
! Wikitext 和 结果
|-
| [[Template:Bug]] 通知读者[[Wikipedia:Software bug|bug]]。
| {{tlc|bug|数量是应有的两倍。小心！}}<br>{{bug|数量是应有的两倍。小心！}}
|-
| [[Template:Clarify]] 标记应该澄清的事项。
| <code>PAS是用于玩家或NPC AI声音检测的一种包围框。{{tlc|clarify}}</code><br>PAS是用于玩家或NPC AI声音检测的一种包围框。{{clarify}}
|-
|rowspan=2| [[Template:Confirm]] 标记需要确认的内容。它的绿色用于突出显示。
| {{tlc|confirm|始终向左移动。}}<br><div style="margin:0.4em 1em 0.5em;">{{confirm|始终向左移动。}}</div>
|-
|<code>始终向左移动。{{tlc|confirm}}</code><

br>始终向左移动。{{confirm}}
|-
| [[Template:Distinguish]] 让您通知用户有关共享相似名称的页面或可能被误认为其他内容的页面。
| {{tlc|distinguish|"跟随弗里曼！"|desc1{{=}}HL2章节}}<br>{{distinguish|"跟随弗里曼！"|desc1=HL2章节}}
|-
| [[Template:How]] 提出问题''如何?''。
| <code>玩家可以越过这些。{{tlc|how}}</code><br>玩家可以越过这些。{{how}}
|-
| [[Template:Idea]] 是提出建议的好方法。
| {{tlc|idea|奖励玩家的聪明和创造性，而不是强制性的一种方式。}}<br>{{idea|奖励玩家的聪明和创造性，而不是强制性的一种方式。}}
|-
| [[Template:Main]] 注明有关某一特定主题的更详细文章。
| {{tlc|main|Soundscripts}}<br>{{main|Soundscripts}}
|-
| [[Template:Note]] 用于突出显示注释。
| {{tlc|note|如果不指定位置，这将在地图原点生成。}}<br>{{note|如果不指定位置，这将在地图原点生成。}}
|-
| [[Template:Question]] 表示问题
| {{tlc|question|这在较新的引擎分支中有效吗？}}<br>{{question|这在较新的引擎分支中有效吗？}}
|-
| [[Template:Suggestion]] 用于提出建议
| {{tlc|suggestion|关卡应该针对最佳性能进行优化。}}<br>{{suggestion|关卡应该针对最佳性能进行优化。}}
|-
| [[Template:Tip]] 将文本标记为读者的提示。
| {{tlc|tip|使用顶点编辑工具时，这个过程要简单得多。}}<br>{{tip|使用顶点编辑工具时，这个过程要简单得多。}}
|-
| [[Template:Todo]] 标记需要完成的任务。它的绿色用于突出显示。
| {{tlc|todo|找到游戏文件中的位置。}}<br><strong style="color:#8BC53F;white-space:nowrap;">待办事项:&nbsp;</strong>找到游戏文件中的位置。
|-
| [[Template:Warning]] 标记读者在做某事时应注意的事项。
| {{tlc|warning|该工具已知会损坏文件。请尝试下面列出的备用方法。}}<br>{{warning|该工具已知会损坏文件。请尝试下面列出的备用方法。}}
|-
| [[Template:Workaround]] 通知读者一个解决方法
| {{tlc|workaround|应该使用逻辑自动化此操作。}}<br>{{workaround|应该使用逻辑自动化此操作。}}
|-
| [[Template:Why]] 提出问题''为什么?''。
| <code>此着色器已被弃用。{{tlc|why}}</code><br>此着色器已被弃用。{{why}}
|}

===通知模板===
以下是一些{{LCategory|Notice_templates|通知模板}}的列表。
{| class="wikitable mw-collapsible" width=100% style=background-color:transparent
! 描述
!width=70%| Wikitext 和 结果

|-
| {{tl2|Cleanup}} 标记需要修复的页面，最好由了解情况的人进行。文本消息是可选的。如果您在转录或讨论页面上没有提供足够的通知原因，则可以预期其他人将其删除。
| {{tlc|cleanup|最后一部分需要澄清。}}<br>{{cleanup|nocat=1|最后一部分需要澄清。}}

|-
| {{tl2|Delete}} 标记应删除的页面。如果您在转录或讨论页面上没有提供足够的通知原因，则可以预期其他人将其删除。在页面上放置此标记时，您还应在该页面的讨论页面上列出原因，以供将来可能希望了解删除目的的读者查看。
| {{tlc|delete}}{{delete|nocat=1}}
|-

| {{tl2|Merge}} 是一个通知，通知编辑人员建议将两个或更多页面合并为一个。在执行任何合并操作之前，应进行讨论。
| {{tlc|merge|HDR}}<br>{{merge|{{L|HDR}}|nocat=1}}
|-

| {{tl2|Messagebox}} 提供标准消息框。该模板被许多通知模板使用。
| {{tlc|messagebox|text{{=}}请记得遵守维基礼仪。}}<br>{{messagebox|text=请记得遵守维基礼仪。}}

|-

| {{tl2|Metanotice}} 是{{tl|Messagebox}}的现代化替代方案。它的语法简单但非常模块化。
| {{tlc|metanotice|text{{=}}这是您要找的吗？}}<br>{{metanotice|text=这是您要找的吗？}}

|-
| {{tl2|Morescreenshots}} 标记应该有更多图像的页面。它允许可选的文本消息以阐明需要图像的内容。
| {{tlc|morescreenshots|$envmapcontrast, $envmapsaturation}}<br>{{messagebox
 |text = 此文章或部分需要更多截图：<p style="font-style: italic;">$envmapcontrast, $envmapsaturation</p>| .
 |small = 您可以在{{LSpecial|Upload}}上传截图。有关帮助，请参阅{{LHelp|Images}}。 
 |image = [[File:Nuvola apps ksnapshot.png|50px|link=]]
 |bdcolor = #F4C430
 }}

|-
| {{tl2|Obsolete}} 标记不应再使用的内容。接受三个参数，实体、工具和着色器。
| {{tlc|obsolete|entity{{=}}1}}<br>{{messagebox
 |text = 此实体已经'''过时'''；不鼓励使用它，它可能仅存在/功能在较旧的引擎分支中。
 |image = [[File:obsolete.png|40px|link=]]
 |bdcolor = #F4C430
 }}

|-
| {{tl2|Spammer}} 标记应该因垃圾邮件而被禁止的用户。对于可疑但不能被禁止的行为，还有[[Template:Minor Spammer]]。{{bug|有时该模板的格式可能看起来奇怪。它意在成为页面上唯一的东西。}}
| {{tlc|spammer}}<br>[[File:Spammer.jpg|left]]
<div style="overflow:auto;">
{{Note|''此用户是[[Wikipedia:Spammer|垃圾邮件发送者]]，[[Wikipedia:Vandalism|破坏者]]或其他问题发布者，应考虑{{LSpecial|Ipblocklist|禁止}}''}}
----
* [{{SERVER}}{{localurl:Special:Blockip|ip={{PAGENAMEE}}}}&wpBlockExpiry=infinite&wpHardBlock=1&wpAutoBlock=1&wpCreateAccount=0$wpBlockEmail=1&wpBlockReasonList=Spamming 封禁此用户。] (需要管理员权限)
* [{{SERVER}}{{localurl:Special:Log|type=block&page=User:{{PAGENAMEE}}}} 检查此用户是否已被封禁。]
* {{LSpecial|Contributions/{{PAGENAMEE}}|查看此用户的贡献。}}
</div>

|-
| {{tl2|Banned user}} 标记已经被禁止（通常由Valve员工）因垃圾邮件，破坏页面，编辑战争或玩弄 along with many other reasons。
| {{tlc|Banned user}}{{Banned user|nocat=1}}
|-
| {{tl2|Split-apart}} 标记应该分割成多个页面的页面。所有拆分操作都应在执行之前进行讨论。
| {{tlc|split-apart}}{{split-apart|nocat=1}}
|-
| {{tl2|Stub}} 标记非常小的页面。请参阅{{LHelp|Stubs}}以获取有关使用的信息。
| {{tlc|stub}}{{stub|nocat=1}}

|-
| {{tl2|Translate}} 标记需要翻译的页面，并将页面添加到一个类别。
| {{tlc|Translate}}{{translate|nocat=1}}

|-
| {{tl2|Update}} 标记过时的页面。
| {{tlc|update}}{{update|nocat=1}}

|-
| {{tl2|Wip}} 标记正在进行重大编辑的页面。添加者要求其他用户在此期间不要编辑。
| {{tlc|Wip}}{{wip|nocat=1}}

|-
| {{tl2|Draft}} 标记目前正在工作的页面。
| {{tlc|draft}}{{draft|nocat=1}}
|}

===杂项模板===

这些模板的目的是帮助编辑人员。
{| class="wikitable mw-collapsible" width=100% style=background-color:transparent
! 描述
!style=width:60%| Wikitext 和 结果
|-
|rowspan=2| [[Template:=]] 是一个只返回等号的模板。有时候需要这个字符，因为多个维基功能会用到它。特别是在模板调用中，等号是一个特殊字符，所以如果等号应该作为参数值传递，那么需要使用{{tlc|{{=}}}}进行“转义”。出于同样的目的，还有[[Template:!]]用于管道符、[[Template:(((]]用于大括号等等，详见{{LCategory|Templates for within templates}}。
| {{tlc|{{=}}}}<br>{{=}}
|-
| {{tlc|note|如果 x &#123;&#123;{{=}}&#125;&#125; 0，你就输了。}}<br>{{note|如果 x {{=}} 0，你就输了。}}

|-
| [[Template:Clr]] 清除悬浮表格、悬浮图片等左右两侧的垂直空间。要仅清除一侧，请使用{{tlc|clr|left}}或{{tlc|clr|right}}。这通常在标题之前使用，以将它们向下推，使其不会出现在图像旁边。在右侧的示例中，也可以使用{{tlc|clr|left}}达到同样的效果。
| <code><nowiki>[[File:Skull and crossbones.png|50px|left]]
这段文字在图像旁边。{{clr}}这段文字在图像下面。</nowiki></code><br><br>
[[File:Skull and crossbones.png|50px|left]]
这段文字在图像旁边。{{clr}}这段文字在图像下面。

|-
| [[Template:Ent]] 是一个非常小的模板，用于制作既是代码又是链接的文本。
| {{tlc|ent|noclip}}<br>{{ent|noclip}}

|-
|rowspan=2| [[Template:Expand]] 或 [[Template:ExpandBox]] 允许您隐藏盒子内的内容，以便它不会使页面变得太长。
| {{todo|example}}

|-
| [[Template:Param]] 以模板中使用的方式显示值，类似于参数。对模板文档非常有用。
| {{tlc|param|color|#fff}}<br>{{Param|color|#FFF}}

|-
| [[Template:Shortcut]] 显示一个小框，指示（缩写的）重定向到一个页面。
| {{tlc|shortcut|VDC:AL}}<br>{{shortcut|VDC:AL}}

|-
| [[Template:Tl2]] 代表'''T'''emplate '''L'''ink（2代表它是一个较老模板的替代）。它创建一个由&#123;&#123; &#125;&#125;包围的模板链接。它还接受行为像链接的模板的参数。
| {{tlc|tl2|note|Example}}<br>{{tl2|note|Example}}
|-
| [[Template:Tlc]] 做同样的事情，但不创建链接，这在尝试显示模板示例时非常有用（就像整个页面一样！）。
| {{tlc|tlc|note|Example}}<br>{{tlc|note|Example}}
|-
| [[Template:Toc-right]] 将{{LHelp|Table of Contents|目录}}移到页面的右侧。
| 请参见{{L|Half-Life 2 map reference}}的示例。

|-
| [[Template:Unsigned]] 用于{{LHelp|Etiquette|讨论页面}}。应在未签名评论的末尾添加。
| {{tlc|unsigned|JeffLane}}<br>{{unsigned|JeffLane}}
|}

==魔术词==
魔术词是一种特殊的字符字符串，有点像模板。要应用一个魔术词，只需在页面上键入它。

===<code><nowiki>__TOC__</nowiki></code>===
强制{{LHelp|Table of Contents|目录}}放置在此位置。

===<code><nowiki>__FORCETOC__</nowiki></code>===
强制将目录放置在其正常位置。（仅在页面没有足够的章节自动显示目录时有用。）

===<code><nowiki>__NOTOC__</nowiki></code>===
隐藏目录。

===<code><nowiki>__HIDDENCAT__</nowiki></code>===
将{{LHelp|Categories|类别}}标记为隐藏。要让网站为您显示隐藏的类别，请在{{LSpecial|Preferences#mw-prefsection-rendering|特殊:首选项}}中勾选'''显示隐藏类别'''框。

===<code><nowiki>{{DISPLAYTITLE:title}}</nowiki></code>===
仅更改页面顶部栏的标题。

==另请参阅==
*{{LSpecial|ExpandTemplates}} - 显示模板的完全展开版本，包括替换的维基文本代码和任何嵌套模板的自动替换。
*{{LSpecial|MostLinkedTemplates}} - 列出页面上最常用的模板。这并不仅仅显示实际的模板；任何页面都可以被引用。
*{{LSpecial|UncategorizedTemplates}} - 列出未列在任何类别下的模板。
*{{LSpecial|UnusedTemplates}} - 列出未在任何页面上使用的模板。
*{{LSpecial|WantedTemplates}} - 列出页面上经常使用但不存在的模板。理想情况下，此列表不应显示任何页面。
*[[Wikipedia:Help:Magic_words_for_beginners]] - 关于魔术词的更多信息。
*[[Wikipedia:Help:Template]] - 模板编程的一个非常有用的资源。
*[[New Help Desk]] - 有问题？在这里提问。