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

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

一般设计指引

编辑

严重级别

编辑

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

  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>