查看“模板:Ambox/doc”的源代码

<includeonly><!-- {{template doc page transcluded}} -->{{intricate template}}</includeonly><noinclude></noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->

本模板是'''条目消息框'''（'''a'''rticle '''m'''essage '''box'''，'''ambox'''）模板所使用的元模板。

它用于创造文章消息框模板例如{{tl|wikify}}等。 它提供几种不同的颜色，用于节省图像，图像参数，它有其他特点。

'''请注意：'''这个模板只用于在条目名字空间使用的模板，其他名字空间使用的模板请不要使用。

此元模板只是在[[MediaWiki:Common.css]]中有关条目消息框的CSS类的简单套用。

这些类可以直接使用在[[Help:表格|维基表格]]中，特别是在有特殊功能需求时：可参见[[Wikipedia:条目消息框的CSS类|其用法指南]]。

'''注意：'''

如果下方两个消息框看起来不一致，请刷新你的网页浏览器缓存：

{{ambox
| image = none
| text = {{tl|ambox}}产生的消息框。
}}
{| style="width: 80%; margin: 0 auto; border-collapse: collapse; background: #FBFBFB; border: 1px solid #aaa; border-left: 10px solid #1e90ff;"
|- 
| style="padding: 0.25em 0.5em;" | <span style="font-size:98%;">硬编码的消息框。</span>
|}

有时候此模板会出现暂时性的缓存错误。

=== 使用方法 ===

简单应用的例子：

<pre>
{{ambox | text = 一些文字。}}
</pre>

{{ambox | text = 一些文字。}}


复合应用的例子：

<pre>
{{ambox
| type  = style
| image = [[File:Icon apps query.svg|38px]]
| text  = 消息框的主体文字。
}}
</pre>
{{ambox
| type  = style
| image = [[File:Icon apps query.svg|38px]]
| text  = 消息框的主体文字。
}}

==== 默认图像 ====

以下范例使用了不同的'''type'''参数，但没有使用image参数，因而使用了各type（类型）所对应的预设图像。

{{ambox
| type  = speedy
| text  = type=<u>speedy</u>－请求速删，如{{tl|delete}}。
}}
{{ambox
| type  = delete
| text  = type=<u>delete</u>－请求删除，如{{tl|afd}}与{{tl|vfd}}。
}}
{{ambox
| type  = content
| text  = type=<u>content</u>－内容问题，如{{tl|POV}}与{{tl|globalize}}。
}}
{{ambox
| type  = style
| text  = type=<u>style</u>－格式问题，如{{tl|cleanup}}与{{tl|wikify}}。 
}}
{{ambox
| type  = move
| text  = type=<u>move</u>－合并、拆分及跨维基提议，如{{tl|split}}与{{tl|copy to wiktionary}}。
}}
{{ambox
| type  = protection
| text  = type=<u>protection</u>－页面保护，如{{tl|Protected}}。
}}
{{ambox
| type  = notice
| text  = type=<u>notice</u>－条目注意，如{{tl|current}}与{{tl|inuse}}。 
}}

==== 其他图像 ====
上方显示的预设图像是十分方便的，但在很多情况下需要使用特别指定的图像。以下是一些使用'''image'''参数来指定其他图像的案例：

{{ambox
| type  = content
| image = [[File:Unbalanced scales.svg|40px]]
| text  = type = content <br> image = <nowiki>[[File:Unbalanced scales.svg|40px]]</nowiki> <br> 这张图像通常用于{{tl|POV}}及其他相似的模板中。
}}
{{ambox
| type  = style
| image = [[File:Wikitext.svg|50px]]
| text  = type = style <br> image = <nowiki>[[File:Wikitext.svg|50px]]</nowiki> <br> 这张图像通常用于{{tl|wikify}}等模板。
}}
{{ambox
| type  = move
| image = [[File:Merge-arrows.svg|50px]]
| text  = type = move <br> image = <nowiki>[[File:Merge-arrows.svg|50px]]</nowiki> <br> 这张图像通常用于{{tl|merge}}等模板。
}}

==== 特殊设定 ====

此外，还有一些其他的参数。

{{ambox
| text  = 未给出type和image参数（'''default'''）
}}
{{ambox
| image = none
| text  = 未给出type且'''image=none'''－不使用图片，而'''text'''将占用消息框的整个区域。
}}
{{ambox
| image = [[File:Gnome globe current event.svg|42px]]
| imageright = [[File:Nuvola apps bookcase.svg|40px]]
| text  = image = <nowiki>[[File:Gnome globe current event.svg|42px]]</nowiki> <br> imageright = <nowiki>[[File:Nuvola apps bookcase.png|40px]]</nowiki>
}}
{{ambox
| image = [[File:Gnome globe current event.svg|42px]]
| imageright = [[File:Shuttle.svg|20px]]
| text  = '''此条目或章节描述的是一次正在进行的空间任务。'''
<br>内容可能会随任务进程而更新。
}}

=== 参数 ===
所有参数的列表：

<pre>
{{ambox
| type  = delete / speedy / content / style / merge / growth / notice
| image = none / blank / [[File:Some image.svg|40px]]
| imageright = [[File:某幅图像.svg|40px]]
| text  = 消息框的主体文字。
}}
</pre>

'''type'''
:如果不指定'''type'''参数的话，会返回用于“条目注意”的预设类型'''notice'''的模板。这意味着会像上文中的简单应用那样产生一个蓝色的边框。

'''image'''
:'''无参数''' = 如果不指定'''image'''参数的话，会返回使用预设图像的模板。至于是哪张预设图像则取决于'''type'''参数。
:'''一幅图像''' = 应该是一幅带有常见维基符号的图像。通常为40px－50px的宽度，这取决于图像的长宽比。例如：
::<code><nowiki>[[File:Unbalanced scales.svg|40px]]</nowiki></code>
:'''none''' = 不使用图像。
:'''blank''' = 不使用图像，但空出与预设图像宽度相当的区域，这可以让不使用图像的消息框与其他使用图像的消息框对齐。（见[[#特殊设定]]）

'''imageright'''
:'''无参数''' = 如果不指定'''imageright'''参数的话，会返回右侧不带图像的模板。
:'''一幅图像''' = 应该是一幅带有常见维基符号的图像。通常为40px－50px的宽度，这取决于图像的长宽比。例如：
::<code><nowiki>[[File:Nuvola apps bookcase.png|40px]]</nowiki></code>
:'''其他内容''' = 任何你想在模板右侧显示的其他内容。

'''text'''
:消息框的主体文字。

=== 技术细节 ===
如果你需要在text参数中使用一些特殊字符的话，那么就需要像这样将它们换码：

<pre>
{{ambox
| text  = <div>
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连着的后大括号<nowiki>}}</nowiki>则不能直接使用。
一起用同样要带nowiki标记<nowiki>|}}</nowiki>。
</div>
}}
</pre>

{{ambox
| text  = <div>
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连着的后大括号<nowiki>}}</nowiki>则不能直接使用。
一起用同样要带nowiki标记<nowiki>|}}</nowiki>。
</div>
}}

此模板使用CSS类来确定显示风格，因此可被更换到其他风格。

在此元模板内使用了HTML的表格标示法，而没有使用维基式的表格标示法。在制作元模板时这是一个常见的方法，因为维基式标示法存在一些缺陷。譬如，维基式标示法会加大[[Help:模板扩展语法|模板扩展语法]]及参数中特殊字符使用的难度。

此元模板所用的缺省图片用的是png格式的，而不是svg格式。其主要原因是在处理MediaWiki为svg图片所渲染的透明背景时，一些老版本的网络浏览器会遇到一些麻烦。这里的png格式图片有手工优化过的透明背景颜色，因而在所有的浏览器中它们看上去都是好的。请注意，svg图标只会在一些老版本的浏览器中看上去有点不对头，因此只有那些非常广泛使用的图标才值得费些功夫去做那种手工优化。

更多的技术细节参见[[{{TALKPAGENAME}}|讨论页]]以及下方的[[#参见]]一节。

=== 参见 ===
在消息框（mbox）家族中有好几个元模板：
* {{tl|ambox}} – 用于条目消息框。
* {{tl|fmbox}} – 用于页眉和页脚消息框。
* {{tl|mbox}} – 有名字空间探测功能。某些消息框会用在几类页面并因此需要依据所用在的页面来改变风格，这种情况下的消息框可以用此元模板。

其他页面：
* [[Wikipedia:条目消息框的CSS类]]－描述如何在[[Help:表格|维基表格]]和HTML表格中直接使用条目消息框的CSS类。
* [[Wikipedia:条目消息框]]－（被提议的）创建条目消息框时应遵循的格式指引。
* [[Wikipedia talk:条目消息框]]－讨论相关的事宜。

<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
</includeonly>