跳至內容

模板:Cmbox/doc

維基百科,自由的百科全書
訊息框元模板
模板背景
{{Ambox}}條目
{{Cmbox}}分類
{{Imbox}}圖片
{{Tmbox}}討論
{{Fmbox}}頁腳/標題
{{Ombox}}其他頁面
{{Mbox}}自動偵測
{{Asbox}}小作品
{{Dmbox}}消歧義

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

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

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


用法

簡單應用的例子:

{{cmbox | 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(類型)所對應的預設圖像。

其他圖片

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

特殊設定

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

參數

所有參數的列表:

{{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>
}}

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

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

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

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

參見

在訊息框(mbox)家族中的元模板:

  • {{ambox}}:用於條目訊息框
  • {{tmbox}}:用於討論頁訊息框
  • {{imbox}}:用於圖像頁訊息框
  • {{cmbox}}:用於分類訊息框
  • {{ombox}}:用於其他頁面訊息框
  • {{mbox}}:有名字空間探測功能。某些消息框會用在幾類頁面並因此需要依據所用在的頁面來改變風格,這種情況下的消息框可以用此元模板。

有相近關係的元模板:

  • {{fmbox}}:用於頁眉和頁腳訊息框
  • {{dmbox}}:用於消歧義以及設定索引訊息框
  • {{asbox}}:用於小作品訊息框