Template: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>。
</div>
}}

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

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

更多資訊，請參閱維基百科上的相同模板。