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

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

本模板是'''条目-{A|zh-hans:消息;zh-hant:訊息}-框'''（'''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 = [[Image:Icon apps query.svg|38px]]
| text  = 消息框的主体文字。
}}
</pre>
{{ambox
| type  = style
| image = [[Image:Icon apps query.svg|38px]]
| text  = 消息框的主体文字。
}}

==== 預設圖像 ====

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

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

==== 特殊設定 ====

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

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

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

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

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

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

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

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

=== 技術細節 ===
如果你需要在text参数中适用一些特殊字符的话：

<pre>
{{ambox
| text  = <div>
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连接的后大括号&lt;nowiki>}}&lt;/nowiki>则不能直接使用。
现在一起用来看看&lt;nowiki>|}}&lt;/nowiki>。
</div>
}}
</pre>

{{ambox
| text  = <div>
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连接的后大括号<nowiki>}}</nowiki>则不能直接使用。
现在一起用来看看<nowiki>|}}</nowiki>。
</div>
}}

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

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

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

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

<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:維基百科元模板|Ambox]]

<!-- ADD INTERWIKIS BELOW THIS LINE -->
[[en:Template:Ambox]]
[[ka:თარგი:Ambox]]
[[pl:Szablon:Ambox]]
[[th:แม่แบบ:Ambox]]
</includeonly>