模板:Ambox/doc
這是 {{Ambox}} 模板的說明文件頁面。 本文件並不是為直接瀏覽而撰寫。若是其中使用了跨維基計畫連結,某些連結可能會顯示損毀。請勿將這些連結替換為硬編碼的頁面名稱或網址。 |
本模板是文章訊息框(article message box,ambox)模板所使用的元模板。
它用於創造文章消息框模板例如{{wikify}}等。 它提供幾種不同的顏色,用於節省圖像,圖像參數,它有其他特點。
請注意:這個模板只用於在教科書名字空間使用的模板,其他名字空間使用的模板請不要使用。
此元模板只是在MediaWiki:Common.css中有關文章消息框的CSS類的簡單套用。
這些類可以直接使用在維基表格中,特別是在有特殊功能需求時:可參見其用法指南。
注意:
如果下方兩個消息框看起來不一致,請刷新你的網頁瀏覽器緩存:
{{ambox}}產生的消息框。 |
硬編碼的消息框。 |
有時候此模板會出現暫時性的緩存錯誤。
使用方法
[編輯]簡單應用的例子:
{{ambox | text = 一些文字。}}
一些文字。 |
複合應用的例子:
{{ambox | type = style | image = [[File:Icon apps query.svg|38px]] | text = 消息框的主体文字。 }}
消息框的主體文字。 |
預設圖像
[編輯]以下範例使用了不同的type參數,但沒有使用image參數,因而使用了各type(類型)所對應的預設圖像。
type=serious-嚴重問題,如{{afd}}與{{vfd}}。 |
type=content-內容問題,如{{POV}}與{{globalize}}。 |
type=style-格式問題,如{{cleanup}}與{{wikify}}。 |
type=merge-合併、拆分及跨維基提議,如{{split}}與{{copy to wiktionary}}。 |
type=protection-頁面保護,如{{Protected}}。 |
type=notice-文章注意,如{{current}}與{{inuse}}。 |
其他圖像
[編輯]上方顯示的預設圖像是十分方便的,但在很多情況下需要使用特別指定的圖像。以下是一些使用image參數來指定其他圖像的案例:
type = content image = [[File:Unbalanced scales.svg|40px]] 這張圖像通常用於{{POV}}及其他相似的模板中。 |
type = style image = [[File:Wikitext.svg|50px]] 這張圖像通常用於{{wikify}}等模板。 |
type = merge image = [[File:Merge-arrows.svg|50px]] 這張圖像通常用於{{merge}}等模板。 |
特殊設定
[編輯]此外,還有一些其他的參數。
未給出type和image參數(default) |
未給出type且image=blank-產生一個與預設圖像寬度相當的空白區域,讓text參數的內容可以與其他消息框對齊。 |
未給出type且image=none-不使用圖片,而text將占用消息框的整個區域。 |
image = [[File:Gnome globe current event.svg|42px]] imageright = [[File:Nuvola apps bookcase.png|40px]] |
此文章或章節描述的是一次正在進行的空間任務。
內容可能會隨任務進程而更新。 |
參數
[編輯]所有參數的列表:
{{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> }}
等號 = 與前後大括號{ }可以正常地使用。 但是管道符|與兩個連着的後大括號}}則不能直接使用。 一起用同樣要帶nowiki標記|}}。 |
此模板使用CSS類來確定顯示風格,因此可被更換到其他風格。
在此元模板內使用了HTML的表格標示法,而沒有使用維基式的表格標示法。在製作元模板時這是一個常見的方法,因為維基式標示法存在一些缺陷。譬如,維基式標示法會加大模板擴展語法及參數中特殊字符使用的難度。
此元模板所用的缺省圖片用的是png格式的,而不是svg格式。其主要原因是在處理MediaWiki為svg圖片所渲染的透明背景時,一些老版本的網絡瀏覽器會遇到一些麻煩。這裡的png格式圖片有手工優化過的透明背景顏色,因而在所有的瀏覽器中它們看上去都是好的。請注意,svg圖標只會在一些老版本的瀏覽器中看上去有點不對頭,因此只有那些非常廣泛使用的圖標才值得費些功夫去做那種手工優化。
參見
[編輯]在消息框(mbox)家族中有好幾個元模板:
- {{ambox}} – 用於文章消息框。
- {{tmbox}} – 用於討論頁消息框。
- {{imbox}} – 用於圖像頁消息框。
- {{cmbox}} – 用於分類消息框。
- {{ombox}} – 用於其他頁面消息框。
- {{fmbox}} – 用於頁眉和頁腳消息框。
- {{mbox}} – 有名字空間探測功能。某些消息框會用在幾類頁面並因此需要依據所用在的頁面來改變風格,這種情況下的消息框可以用此元模板。
其他頁面:
- Wikipedia:條目消息框的CSS類-描述如何在維基表格和HTML表格中直接使用條目消息框的CSS類。
- Wikipedia:條目消息框-(被提議的)創建條目消息框時應遵循的格式指引。
- Wikipedia talk:條目消息框-討論相關的事宜。