维基专题:用户警告/Help:模板代码

本页面是用户警告专题文件的一部分。

一般设计指引

严重级别

每个模板系列包含了四个代表着递增的严重性的模板，指明了从友善到严厉的语气。这并没有明确指出时间上的先后顺序，一个用户可以简单地根据其所认为的严重程度选择一个级别。例如，测试的模板系列为：测试1、测试2、测试3、测试4。

提醒：假设该用户不怀恶意——礼貌地指导他去使用沙盒编辑和/或阅读相关的帮助和方针页面，以表示欢迎；
注意：无法假设用户是否怀有恶意——礼貌地请求其停止破坏并提及后果，引导他去沙盒编辑；
警告：假设用户存在主观恶意——严厉制止并打消其念头；
最后警告：假设用户存在主观恶意——强行制止并打消其念头，做出最后警告。

文明

不考虑模板的严重级别的话，对其他用户进行警告时应该严守文明（即使是对于最具危害性的破坏）。记住，当你使用一个警告模板的时候，你是以维基百科的名义这样做的。参见Wikipedia:不要伤害新手，Wikipedia:文明，Wikipedia:礼仪。

衍生模板

模板的派生版本（以新的名义出现的一个模板的一个不遵循标准的变种）不应该被包含在规范化模板的列表里或者在文档内被提及。尽管用户可以自由地创建、使用不遵循标准的模板，这类模板仍不应当为该专题所承认。

模板代码编写指引

模板分类

模板页面

用户警告模板应当被归类到Category:用户警告模板中，如果某一模板是到另一个模板的重定向页面，则应当通过分类关键词“重定向”被归类。用户封禁模板应当被分类到Category:封禁模板中，其分类关键词则视情况定为“暂时”或“无限期”。分类标签应当以noinclude语法标记到模板页面上。

<noinclude>
[[Category:用户警告模板]]
[[Category:封禁模板|无限期]]
</noinclude>

用户讨论页

任何将它被应用到的页面添加进一个分类的模板，都应当用分类参数前后包围住分类标签。如果模板使用<noinclude>标签，请注意将参数放置在此标签的里面。这样，在一个页面（例如讨论页面或列表页面）上使用模板时，不必通过加入未指定的分类参数值（{{template|category=}}）来添加该页面到一个分类里。

<includeonly>{{category|[[Category:封禁模板|无限期]]}}</noinclude>

模板参数

默认值

几乎每一个模板都有一个默认值，这样，错误使用模板时，不会使模板效果大打折扣。你可以通过使用管道语法（{{{1|default value}}}）来设置一个参数的默认值。例如，下面的模板采用了一个希望用户提供正确的代词的参数：

{{{1|He or she}}} is cool.

使用{{template|He}}来提供代词时，模板将会变成"He is cool"；使用{{template}}忽略掉参数的话，模板将会显示默认值并变成 "He or she is cool"。

具名语法

当一个模板的参数可能会被加入能够破坏模板的符号（尤其是“|”管道符号和“=”等号）时，一个具名语法能够阻止这种情况的发生。这种情况下，具名和非具名语法是可以依需要共存的。例如，一个Wikilink模板可以通过“嵌套”（将参数放在其他参数的默认值中）的方法来同时指定一个名字和一个数字到参数当中：

[[{{{link|{{{1|{{{default value}}}}}}]]

使用{{template|article}}足够容易理解，并且会变成[[article]]。但是，一些符号如果这么用的话会破坏掉模板。这种情况下，需要具名语法：{{template|link=article|name}}，这样子会变成 [[article|name]]。

嵌套式替换引用

任何包含模板、魔术变量（英语：magic variables）或者是解析器函数的模板都应该在一个适合“Subst:”修饰符放置的地方包含一个可选的“subst”参数。这允许用户能够简单地替换引用一个模板和所有嵌套模板。例如，请看一下下面的模板代码：

现在是{{{{{subst|}}}CURRENTYEAR}}年.

尝试使用 {{subst:template}}替换引用此模板将会显示成"现在是{{CURRENTYEAR}}年"，导致被嵌套的代码无法被替换引用。使用替换引用变量（{{subst:template|subst=subst:}}）的话，此模板将会显示成"现在是2024年"。

封禁模板的CSS代码

维基百科允许注册的用户在user:username/skin.css建立一个个人样式表，“username”是用户名，“Skin”是正在使用的页面样式（通常是monobook）。为了帮助用户充分利用这一功能，封禁模板应当使用“user-block”类，以CSS格式编写。

<div class="user-block">template message</div>

用户如果想这样做的话，他们可以通过将CSS代码加入他们的用户样式表的方法，来自订所有封禁模板的外观。例如，以下的代码加入了衬着红色背景的白色文本。

* .user-block { background:#C00; color:#FFF; }

对列表的兼容性

所有的用户警告与封禁模板都应该原生兼容列表。为了最高的交涉效率，有多个警告的讨论页有时会被组织成结构化的按照日期编排的列表（见导引）。由于维基百科将维基语法解析为HTML代码的方式，列表的项目是不应该包含换行符号的。

有换行符号的模板将会打乱任何它们被放置的列表：第一段将会在列表当中，其他的会被挤出去，任何在列表当中的接下来的模板将会进入一个新的列表。直接使用HTML段落语法的话，维基百科的段落解析将会被绕开，多段落的模板就可以不出差错地加入到组织后的警告列表里了。

<p>段落1。</p><p>段落2。</p><p>段落3。</p>

为了避免换行符产生的问题，模板必须只有单独的一个代码行。但是，编辑视图下，对于人类来说这是十分晦涩的。为了保证可读性，HTML注释可以插入进去，以模仿出换行的效果。尽管这看起来和两栏的代码行不太协调，但是在应用在实际的段落中的时候，注释会变得不那么占地方。

<p>段落1。</p><!--
--><p>段落2。</p><!--
--><p>段落3。</p>