模板:Cmbox/doc

本模板是{{cmbox}}或 分類信息框（category message box）元模板。

它用於建立分類頁面的消息框模板，如{{CatDiffuse}}等。它提供若干種不同的顏色，當無圖像參數給出時使用預設圖像，它還有其他特點。

該模板的工作與{{ambox}}幾乎相同，並使用同樣的參數。

用法

簡單應用的例子：

{{cmbox | text = Some text.}}

Some text.

複雜應用的例子：

{{cmbox
| type      = style
| image     = [[File:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = 消息框的主体文字。
}}

消息框的主體文字。

分類信息框類別

以下範例使用了不同的type參數，但沒有使用image參數，因而使用了各type（類型）所對應的預設圖像。

type=speedy – 快速刪除模板，如{{db-catempty}}.

type=delete – 刪除模板，如{{cfd}}.

type=content – 大警告與問題，如{{CategorisationDisputedPeople}}.

type=style – 小警告與問題，如{{popcat}}.

type=notice – 各種提示與信息，永久性的與暫時性的。

type=move – 移動，合併與分割信息和提議,如{{categoryredirect}}.

type=protection – 保護模板，如{{pp-semi-protected}}，當顯示於分類頁面上時。

其他圖片

上方顯示的預設圖像是十分方便的，但在很多情況下需要使用特別指定的圖像。以下是一些使用image參數來指定其他圖像的案例：

type = style
image = [[File:Sub-arrows.svg|40px]]
這張圖像通常用於{{verylarge}}和 {{CatDiffuse}}.

type = move
image = [[File:Redirect arrow.svg|52px]]
這張圖像通常用於 {{categoryredirect}}.

特殊設定

此外，還有一些其他的參數。

未給出type和image參數 (default)

未給出type且 image=none – 不使用圖片，而text將占用消息框的整個區域。

image = [[File:Gnome globe current event.svg|42px]]
imageright = [[File:Nuvola apps bookcase.svg|40px]]

此分類下的條目當前正在進行空間任務。
由{{current spaceflight}}模板集中。

參數

所有參數的列表：

{{cmbox
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[File:Some image.svg|40px]]
| imageright = [[File:Some image.svg|40px]]
| style = CSS values
| textstyle = CSS values
| text  = The message body text. 
}}

type

如果不指定type參數的話，會返回用於「條目注意」的預設類型notice的模板。這意味着會像上文中的簡單應用那樣產生一個藍色的邊框。

image

No parameter = 如果不指定image參數的話，會返回使用預設圖像的模板。至於是哪張預設圖像則取決於type參數。

An image = 應該是一幅帶有常見維基符號的圖像。通常為40px－50px的寬度，這取決於圖像的長寬比。（但消息框可應付各種尺寸的圖像。）例如：

image = [[File:Sub-arrows.svg|40px]]

none = 不使用圖像。

imageright

No parameter = 如果不指定imageright參數的話，會返回右側不帶圖像的模板。

An image = 應該是一幅帶有常見維基符號的圖像。通常為40px－50px的寬度，這取決於圖像的長寬比。（但消息框可應付各種尺寸的圖像。）例如：

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

Anything = 任何你想在模板右側顯示的其他內容。

style

An optional CSS value used by the entire message box table. Without quotation marks " ". For example:

style = margin-bottom: 0.5em;

textstyle

An optional CSS value used by the text cell. For example:

textstyle = text-align: center;

text

消息框的主體文字。

技術細節

如果你需要在text參數中使用一些特殊字符的話，那麼就需要像這樣將它們換碼：

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

等號 = 與前後大括號{ }可以正常地使用。 但是管道符|與兩個連着的後大括號}}則不能直接使用。 一起用同樣要帶nowiki標記|}}。

此模板使用CSS類來確定顯示風格，因此可被更換到其他風格。

在此元模板內使用了HTML的表格標示法，而沒有使用維基式的表格標示法。在製作元模板時這是一個常見的方法，因為維基式標示法存在一些缺陷。譬如，維基式標示法會加大模板擴展語法及參數中特殊字符使用的難度。

此元模板所用的缺省圖片用的是png格式的，而不是svg格式。其主要原因是在處理MediaWiki為svg圖片所渲染的透明背景時，一些老版本的網絡瀏覽器會遇到一些麻煩。這裡的png格式圖片有手工優化過的透明背景顏色，因而在所有的瀏覽器中它們看上去都是好的。請注意，svg圖標只會在一些老版本的瀏覽器中看上去有點不對頭，因此只有那些非常廣泛使用的圖標才值得費些功夫去做那種手工優化。

更多的技術細節參見討論頁以及下方的#參見一節。