模板:Ambox/doc

本模板是文章消息框（article message box，ambox）模板所使用的元模板。

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

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

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

这些类可以直接使用在维基表格中，特别是在有特殊功能需求时：可参见其用法指南。

注意：

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

硬编码的消息框。

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

使用方法

简单应用的例子：

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

复合应用的例子：

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

预设图像

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

其他图像

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

特殊设定

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

参数

所有参数的列表：

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

type

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

image

无参数 = 如果不指定image参数的话，会返回使用预设图像的模板。至于是哪张预设图像则取决于type参数。

一幅图像 = 应该是一幅带有常见维基符号的图像。通常为40px－50px的宽度，这取决于图像的长宽比。例如：

[[File:Unbalanced scales.svg|40px]]

none = 不使用图像。

blank = 不使用图像，但空出与预设图像宽度相当的区域，这可以让不使用图像的消息框与其他使用图像的消息框对齐。（见#特殊设定）

imageright

无参数 = 如果不指定imageright参数的话，会返回右侧不带图像的模板。

一幅图像 = 应该是一幅带有常见维基符号的图像。通常为40px－50px的宽度，这取决于图像的长宽比。例如：

[[File:Nuvola apps bookcase.png|40px]]

其他内容 = 任何你想在模板右侧显示的其他内容。

text

消息框的主体文字。

技术细节

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

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

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

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

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

更多的技术细节参见讨论页以及下方的#参见一节。

参见

在消息框（mbox）家族中有好几个元模板：

{{ambox}} – 用于文章消息框。
{{tmbox}} – 用于讨论页消息框。
{{imbox}} – 用于图像页消息框。
{{cmbox}} – 用于分类消息框。
{{ombox}} – 用于其他页面消息框。
{{fmbox}} – 用于页眉和页脚消息框。
{{mbox}} – 有名字空间探测功能。某些消息框会用在几类页面并因此需要依据所用在的页面来改变风格，这种情况下的消息框可以用此元模板。

其他页面：

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