查看“帮助:常用模板简介”的源代码

{{Seealso|返回[[帮助:如何贡献]]页面。}}
模板相当于嵌入页面，可以使得页面更加格式化，代码更加简介、更便于编辑。模板的语法请参见: [[mw:Help:Templates/zh|Mediawiki上的介绍]]

本Wiki已预先准备的模板可参见其他使用模板页面的代码，也可通过查看[[Special:最多嵌入页面]]得到本Wiki的模板列表。

下文对一些通用模板及其语法进行详细介绍。此外，对于本Wiki的各个分类中的专用模板，此处不做介绍，请前往各个分类的[[帮助:如何贡献#分类编辑规范|分类编辑规范]]进行查看。

== Ambox类 ==

Ambox用于表达页面存在的问题。此Wiki提供与Wikipedia相似用法的Ambox模板（一般用于提示页面问题），但是不建议直接使用它，除非是一些特殊标明（即不具有通用性的标明），否则建议使用下列子标题以及各个分区编辑标准中提供的次级Ambox模板。

=== 完善内容 ===

用于标明此页面需要填充更多内容以丰富，通常来说，如果您主要负责某条目的建立与更新且由于时间关系无法在很短时间内更新完毕，请使用此模板。如果您在阅览其余页面时对于其描述对象一知半解并感觉有些内容没有说清楚但是自己却无能力充实内容，请使用此模板。使用此模板会自动将页面归类到[[:Category:需要完善内容的条目]]中。

用法：
<pre><nowiki>{{NeedContent/zh}}</nowiki></pre>

效果：
{{NeedContent/zh}}

==== 空白章节 ====

如果条目只是有一个空白的章节，可以使用 <code><nowiki>{{BlankSection/zh}}</nowiki></code>。该模板也会被自动归入与需要完善内容的页面相同的分类中。

效果：
{{BlankSection/zh}}

=== 更改结构 ===

用于标明此页面结构混乱，需要改动。通常当一个页面叙述顺序让人摸不着头脑，或者叙述语言过于主观化，亲切化，不百科化时，需要用此模板标记页面。使用此模板会自动将页面归类到[[:Category:需要更改结构的条目]]中。

用法：
<pre><nowiki>{{BadFormat/zh}}</nowiki></pre>

效果：
{{BadFormat/zh}}

=== 翻译请求 ===

这是一个英文模板，用于指示当前页面的英文翻译尚未完成，需要有人协助翻译。

用法：
<pre><nowiki>{{Translation}}</nowiki></pre>

效果：
{{Translation}}

如果您大致估算了您已经翻译的量，可以填入完成度百分比：
 <nowiki>{{Translation|50}}</nowiki>
{{Translation|50}}

=== 专业人士协助 ===

标明此页面需要专业人士协助进行编辑，这通常由于此条目涉及一些计算机领域，又或者是条目的相关人士是可以巡回此条目进行编辑的（例如[[Ballex/zh|Ballex]]的作者是可以亲自编辑Ballex条目并优化它，丰富其内容，没有人比作者更了解这一词条了）。

用法：
<pre>{{NeedProfessor/zh}}</pre>

效果：
{{NeedProfessor/zh}}

=== 过时内容 ===

部分页面描述的内容（一般是偏动态的事件等）若不及时更新，页面描述可能会随着相关内容自身的变动而变得不再合适。若您此时无法或不方便更新，请添加此模板。

用法：
 <nowiki>{{Outdated/zh}}</nowiki>

效果：
{{Outdated/zh}}

== 属性类 ==

属性类模板（本站特有）和Ambox的样式类似，不同的是其可定制度更高且在移动版视图中也可以正常查看。与Ambox一样，建议除特殊使用情形，请不要直接使用Attribute模板，而是使用后续描述的各类下级模板

语法:
<pre><nowiki>{{Attribute|属性名称|属性描述|左侧颜色|配图文件名}}</nowiki></pre>

例如如下设置:
<code><nowiki>{{Attribute|额外分数|你得到了220分|lime|ExtraPoint-sample.jpg}}</nowiki></code> 效果如下。

{{Attribute|额外分数|你得到了220分|lime|ExtraPoint-sample.jpg}}

颜色属性需要使用英文的颜色名，也可以使用其他[[Wikipedia:zh-cn:CSS|CSS]]代码支持的颜色格式，常用的有16进制的RGB (例: <code>#34a78f</code>) 等。

=== 动态列表 ===

通常用于需要动态更新的列表型页面，例如排行榜；此模板会将应用的页面自动归类至[[:Category:动态列表]]中，可以通过点击其上的链接进入。

语法：
* <pre><nowiki>{{动态列表}}</nowiki></pre>
效果：
{{动态列表}}

=== 网站 ===

用于标识条目介绍的是网站，例如[[CBA]]和[[GCBA]]。

语法：
* <pre><nowiki>{{Website/zh}}</nowiki></pre>
效果：
{{Website/zh}}

=== 现实人物 ===

用于标识条目描述的是一位真实存在的人物，不希望任何编辑者在此条目恶意添加无中生有、过分恶搞等不客观中立的内容。

语法：
<pre><nowiki>{{RealPeople/zh}}</nowiki></pre>
效果：
{{RealPeople/zh}}

=== 作者编辑/作者巡回 ===

用于标识条目已由条目相关人物确认内容准确性或已进行编辑。内容是可以确信的。

语法：
<pre><nowiki>{{AuthorEdition/zh}}</nowiki></pre>
效果：
{{AuthorEdition/zh}}

=== 因Ballance吧内的各种不可抗力因素而缺失资料 ===

用于标识此词条是因为各种不可抗力因素而缺失资料，导致无法追根溯源。应在帖子恢复后补全词条并移除此模板。添加此模板的词条将自动归类到[[:Category:因Ballance吧内的各种不可抗力因素而需要修复内容的词条]]

语法：
<pre><nowiki>{{TiebaCrash/zh}}</nowiki></pre>
效果：
{{TiebaCrash/zh}}

=== Ubx ===

如果您使用过Wikipedia，那么你一定很熟悉Ubx。这类模板用于且只能用于用户个人页面来表征用户的特点与属性。

考虑到 Ballance Wiki 模板较少，部分模板暂未设置Ubx前缀。

* <pre><nowiki>{{ubx-cantmonorail/zh}}</nowiki></pre>
{{ubx-cantmonorail/zh}}
* <pre><nowiki>{{Mapper/zh}}</nowiki></pre>
{{Mapper/zh}}
* <pre><nowiki>{{Speedrunner}}</nowiki></pre>
{{Speedrunner}}

== 辨别条目类 ==

=== 另见模板 ===

当您需要在一个页面内简要引述另一个条目中的内容时，应将被引述的条目用此模板链接起来以便查阅。
<pre><nowiki>{{Seealso|其他相关排行榜: [[Ballance HS排行榜]]]]}}</nowiki></pre>
效果：
{{Seealso|其他相关排行榜: [[Ballance HS排行榜]]}}

==== 主条目 ====

主条目模板可以视为另见模板的变体，自动填入 <code>主条目: </code> 并链接。

 <nowiki>{{主条目|Ballance吧竞速}}</nowiki>
效果: {{主条目|Ballance吧竞速}}

=== 辨别模板 ===

两个或更多条目具有相近名称且存在一个含义更接近本页面内容的条目时，应加入辨别模板以指出区别。
<pre><nowiki>{{Distinguish|本页是关于玩家可直接操控球的条目，不是作为机关的[[道具球]]的条目。}}</nowiki></pre>
效果：
{{Distinguish|本页是关于玩家可直接操控球的条目，不是作为机关的[[道具球]]的条目。}}

=== 消歧义 ===

多个条目具有相近名称或内容且无法挑选出一个含义更接近的条目时，应在共有名称的页面上使用此模板并于下文指出全部条目的名称和释义。

中文：
<pre><nowiki>{{Disambiguation/zh}}</nowiki></pre>
{{Disambiguation/zh}}
英文版需要去掉 <code>/zh</code>。

''本百科上的例子：[[浮空岛]]''

== 其他语言 ==

目前仅支持中文和英文页面间的切换。
<pre><nowiki>{{Languages|en|Ballance}}</nowiki></pre>
{{Languages|en|Ballance}}
<pre><nowiki>{{Languages|zh|Ballance/zh}}</nowiki></pre>
{{Languages|zh|Ballance/zh}}

== 引言 ==

如果您需要在文章中引用一段别人所说的话，您可以使用如下几种引用方式。

=== 标准引言 ===

您可以使用模板[[Template:Quote]]来创建一段标准引言。

用法：
<pre><nowiki>{{Quote|author|content(|size=)}}</nowiki></pre>，其中<code>size</code>是可选项，表示的是其中文本的大小，默认16px
示例：
<pre><nowiki>{{Quote|四中2014届1班|在Ballance的历史长河中，一代又一代的Ballancer将这款小游戏的最高分一步步逼近极限。他们的青春有多少个夜晚陪着这款游戏度过。十几年来，他们有的早已成家立业，功名身退。有的仍处学府，活跃至今。但无论如何，每一个在挑战极限之路上留下自己印记的吧友都值得被铭记。此贴整理可考的Ballance各关HS最高分发展史，谨以此向每一位在青春为Ballance疯狂过的同志们致敬！}}</nowiki></pre>
效果：
{{Quote|四中2014届1班|在Ballance的历史长河中，一代又一代的Ballancer将这款小游戏的最高分一步步逼近极限。他们的青春有多少个夜晚陪着这款游戏度过。十几年来，他们有的早已成家立业，功名身退。有的仍处学府，活跃至今。但无论如何，每一个在挑战极限之路上留下自己印记的吧友都值得被铭记。此贴整理可考的Ballance各关HS最高分发展史，谨以此向每一位在青春为Ballance疯狂过的同志们致敬！}}

=== 无作者引言 ===

如果您的引言无需显示作者，可以直接使用<pre><nowiki><blockquote>引言</blockquote></nowiki></pre>来达到目的。

示例：
<pre><nowiki><blockquote>罗马不是一天建成的</blockquote></nowiki></pre>
效果：
<blockquote>罗马不是一天建成的</blockquote>

=== “纸片” ===

 <nowiki>{{Paper|text=(|author=)(|size=)(|rotate=)(|inline-block=1)}}</nowiki>

* text 是文字内容。
* author 是作者（选填），不填则不显示。
* size 是文字大小（单位：像素），默认16px。
* rotate 用于模拟纸张的“旋转”。可选单位有deg（度）及rad（弧度）等。
* inline-block=1 (仅有数值设为1时有效): 所引用文字较短时可以使纸张宽度缩短至文段宽度（若不设置，则默认宽度100%）。

示例: 
 <nowiki>{{Paper|text=Lorem ipsum dolor|author=Unknown|size=17.5|rotate=1.2deg|inline-block=1}}</nowiki>
效果: 

{{Paper|text=Lorem ipsum dolor|author=Unknown|size=17.5|rotate=1.2deg|inline-block=1}}

若不设置 <code>inline-block=1</code>，效果则为：
{{Paper|text=Lorem ipsum dolor|author=Unknown|size=17.5|rotate=1.2deg}}

=== 引号式引言 ===

此模板直接照抄自萌娘百科渲染后的HTML文本，实际上维基百科中也存在此模板，但这个模板看起来更像引言。默认情况下的样式是居中且保持最小宽度。当引言很长时，其也可以自动改变自身大小直到达到页面宽度。

示例：

<pre><nowiki>{{Cquote|作者|这是一句引言}}</nowiki></pre>

<pre><nowiki>{{Cquote|作者|这是一句长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长引言}}</nowiki></pre>

效果：

{{Cquote|作者|这是一句引言}}
{{Cquote|作者|这是一句长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长长引言}}

== 样式效果 ==

=== 文字颜色 ===

文字颜色可以直接使用HTML+CSS，而本Wiki提供一个模板可以使之更加方便：
 <nowiki>{{Color|文字|颜色}}</nowiki>
示例 (颜色为浅绿色, 即<code>lightgreen</code>): {{Color|文字|lightgreen}}

如果不填颜色，则显示为本Wiki选择的表'''强调'''用的橙红色（注意和一般橙色不同，该模板提供的文字颜色稍显红色；同时为了方便记忆，也可以使用 <code>Orange</code> 模板）：
 <nowiki>{{Orange|文字}}</nowiki>
效果: {{Orange|文字}}

=== 文字大小 ===

标准的文字大小可能有时不能满足全部需求，这时可以使用模板：
 <nowiki>{{Resize|文字|大小}}</nowiki>
其中，常规文字大小是 16px (像素)，它和其他单位的换算关系是 16px = 1em = 12pt = 100%.

建议使用前两个单位 (px / em)。

若不设置大小则默认是缩小至 0.88em。

效果（设置为14px）： {{Resize|文字|14px}}

=== 格式化 ===

格式化的等宽文本可以通过 HTML 标签（&lt;kbd&gt; 和 &lt;code&gt;）实现，但本 Wiki 准备了相应的模板，使用更加方便（值得注意的是，有时您可能仍然需要手动输入 {{Code|&lt;nowiki&gt;}} 标签）。

* 提示输入文本: {{Code|<nowiki>{{kbd|文本}}</nowiki>}} – {{Kbd|文本}}
* 代码: {{Code|<nowiki>{{code|文本}}</nowiki>}} – {{Code|文本}}

=== 水平横线 ===

有时您虽然不需要另起段落却需要分割文字内容，这时可以用水平横线模板 <code><nowiki>{{HLine|边缘宽度 (可选, 默认 2px)}}</nowiki></code> 模板。
效果：
{{HLine}}
可以看见多了一条横线。
<code><nowiki>{{HLine|8px}}</nowiki></code>
效果: {{HLine|8px}}

=== 点 ===

{{Seealso|详细内容和示例可以在[[模板:Dot]]查看。}}
 <nowiki>{{Dot | 大小 (默认 0.4em) | 颜色 (默认 #26b) | 边缘线样式 (默认 none)}}</nowiki>
{{Dot}} 可以用于指示颜色等。

=== 方块 ===

{{Seealso|详细内容和示例可以在[[模板:Square]]查看。}}
 <nowiki>{{Square | 大小 (默认 1.1em) | 颜色 (默认 #9f9) | 边缘线样式 (默认 1px solid #999)}}</nowiki>
请注意这和“点”模板存在一定区别，例如大小、颜色均不同，且默认有边缘样式。

使用例：<br>下文的表格中的背景色图例: <br>{{Square}} = 可用的, {{Square|1.1em|#ccc}} = 已失效的

== 注意模板 ==

<pre><nowiki>{{Note|注意事项}}</nowiki></pre>
{{Note|注意事项}}

== 来源请求 ==

用法类似[[帮助:常用语法简介#引用脚注]]，当需要引用的地方无法找到或没有描述内容的来源时应使用此模板。使用模板后条目会被自动加入[[:分类:需要注明来源的条目]]中。

* 中文: <code><nowiki>{{来源请求}}</nowiki></code> 或其简化版 <code><nowiki>{{cn/zh}}</nowiki></code><br>效果: {{来源请求}}
* 英文: <code><nowiki>{{citation needed}}</nowiki></code> 或其简化版 <code><nowiki>{{cn}}</nowiki></code><br>效果: {{cn}}

如果需要高亮请求来源的文字，可以使用以下代码（此处仅使用中文为例，英文可类比使用）：
 
<code><nowiki>{{来源请求|需要高亮的文字}}</nowiki></code> 或其简化版 <code><nowiki>{{cn/zh|需要高亮的文字}}</nowiki></code><br>
效果: {{来源请求|需要高亮的文字}}

== 日期类 ==

=== 当前月份 ===

<pre>{{当前月}}</pre>

使用此模板可以显示当前的年份和月份。需要注意的是，如果月份是个位数，则前部不会补上 0 (例如，2019年9月而不是2019年09月)。

* 示例: {{当前月}}

=== 日期换算 ===

==== 仅年份 ====

一般被用于年龄换算等。

计算从一个日期到另一个日期的年份数，''按照周年计算，即不足一年的部分会被直接忽略''。
 <nowiki>{{Age|起始年|起始月|起始日|结束年|结束月|结束日}}</nowiki>
如果需要忽略起始日期的月、日，可以使用 <code>1</code> 代替。

'''结束日期的年月日可以忽略'''，此时以当前日期作为结束日期。允许从后向前计算。

公元前的年份视作正整数向前的延伸，如公元前元年记作0，公元前2年记作-1。

* <code><nowiki>{{Age|2000|4|10|2012|4|20}}</nowiki></code> 得出 {{Age|2000|4|10|2012|4|20}}。
* <code><nowiki>{{</nowiki>Age|2000|4|10|2012|'''3'''|20<nowiki>}}</nowiki></code> 得出 {{Age|2000|4|10|2012|3|20}} (''不足整年的部分被忽略'')。
* <code><nowiki>{{Age|2000|4|10}}</nowiki></code> 得出 {{Age|2000|4|10}}。

==== 显示年、月 ====

可以用于计算某项目发布后经历的时间等既不需要太精确又不需要太模糊的时长。''不足整月的部分会被忽略''。
 <nowiki>{{年月差异|起始年|起始月|起始日|结束年|结束月|结束日}}</nowiki>
如果需要忽略起始日期的月、日，可以使用 <code>1</code> 代替。

'''结束日期的年月日可以忽略'''，此时以当前日期作为结束日期。允许从后向前计算。

公元前的年份视作正整数向前的延伸，如公元前元年记作0，公元前2年记作-1。

* <code><nowiki>{{年月差异|2000|4|10|2012|2|20}}</nowiki></code> 得出 {{年月差异|2000|4|10|2012|2|20}}。
* <code><nowiki>{{</nowiki>年月差异|2000|'''4'''|10|2012|'''4'''|20<nowiki>}}</nowiki></code> 得出 {{年月差异|2000|4|10|2012|4|20}} (''余下月份为0时会直接不显示'')。
* <code><nowiki>{{年月差异|2000|4|10}}</nowiki></code> 得出 {{年月差异|2000|4|10}}。

英文显示需要换成：
 <nowiki>{{AgeYM|起始年|起始月|起始日|结束年|结束月|结束日}}</nowiki>
例如 <code><nowiki>{{AgeYM|2000|4|10|2012|2|20}}</nowiki></code> 得出 {{AgeYM|2000|4|10|2012|2|20}}。

== 文件下载 ==

{{主条目|模板:下载文件}}

[[Category:帮助]]