维基专题:用户警告/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>