模板: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:條目消息框－討論相關的事宜。