模板:Ambox/doc

本模板 {{ambox}} 是條目訊息框的元模板。用於創造文章訊息框模板，如 {{wikify}} 等。此外本模板具有自由選擇不同顏色、顯示特定預設圖片等功能。

請注意：這個模板只用於在條目命名空間使用的模板，其他命名空間使用的模板請不要使用。

常用參數

右側的方框內為 {{ambox}} 模板最常用的參數。每種參數的說明如下：

常用參數
{{Ambox | name = | subst = <includeonly>{{subst:substcheck}}</includeonly> | small = {{{small|}}} | type = | image = | sect = {{{1|}}} | issue = | talk = {{{talk|}}} | fix = | date = {{{date|}}} | time = {{{time|}}} | cat = | all = }}

name

name 參數指定模板的名字，不需要加上模板命名空間字首。例如 {{Wikify}} 中填入的參數為 |name=Wikify。

本參數應該模板被移動時更新。本參數的指定有兩個目的：

• 如果模板被錯誤的替換引用（substituded），這個參數能讓元模板顯示一段警告文字，將可幫助編輯者修復問題。
• 能讓模板在模板頁中更有效地展示，例如在沒有填入日期的情況下自動顯示日期，並能讓模板準確分類。

subst

subst 參數讓元模板能檢測此模板是否被錯誤替代引用的，並顯示一段警告文字。同時也會將頁面加入 Category:錯誤使用替換引用的頁面 分類. 完全複製上述方框中的代碼即可。一般情況下，請勿更改本參數內容，直接複製上方的模板代碼即可。

small

small 參數可讓編輯者在條目中使用模板時輸入 |small=left 來產生一個小型的模板。

一般情況下本模板的顯示效果如下：

其他參數設定方式：

• 如果模板「永遠」不應以縮小的方式顯示，請在模板原始碼中使用 |small=no。
• 如果模板應「總是」以縮小的方式顯示，請在模板原始碼中使用 |small=left。
• 如果模板「預設為縮小顯示」，請在模板原始碼中使用 |small={{{small|left}}}。可讓編輯者在條目中輸入 |small=no 參數時無效。

type

type 參數能指定的模板預設的左側直條顏色和圖片。本參數的選擇並非依據編輯者對顏色的偏好，而是根據模板內訊息的類型來決定。以下是七種可在「type」參數中填入的值：

如果沒有指定 type 參數，預設為 |type=notice。

image

您可以使用 image 參數來指定模板中顯示的圖片。圖片的指定語法與維基百科放置圖片的預設語法相同（參見：如何放置圖片）。一般來說，圖片的寬度約為 40-50px。範例如下：

• {{POV}} 中參數設定為 |image=[[File:Unbalanced scales.svg|40px|link=|alt=]]，其顯示效果如下：

• {{wikify}} 中參數設定為 |image=[[File:Wikitext.svg|50px|link=|alt=]]，其顯示效果如下：

請注意：

• 如果沒有指定圖片，模板將會配合「type」參數的內容選擇適當的圖片（參見：#type）
• 如果參數設定為 |image=none 時將不會顯示任何圖片，訊息框內將僅顯示文字。
• 如果圖片僅為裝飾功能，並屬於公共領域，可如在參數中加上 "|link= 以產生連往圖片描述頁的連結，以及 |alt=" 來產生替代文字；以上兩種做法可提升頁面親和力。

sect

許多條目訊息模板開頭文字為「此條目⋯⋯」，如果此模板用於章節，則應該更適當地使用「此章節⋯⋯」。其他可能性包括「此列表⋯⋯」和「此人物傳記⋯⋯」。

為了實現這個功能。請使用 |sect={{{1|}}} 參數。這將使編輯者能在第一個無名的參數中輸入「章節'」來改變模板所指的條目部分。例如：{{Advert|章節}} 將會顯示： Template:Advert

在使用這個功能時，在模板原始碼中應移除開頭的幾個字（例如：本條目），否則會造成重複顯示。

issue & fix

issue 參數用於描述條目的問題。請儘量保持文字敘述簡潔有力（約在 10-20 個字內），並包含一個連結至有關的方針與指引頁面。

fix 參數包含描述如何改進條目的指導文字。文字內容可比 issue 參數中所填入的字數多，在大多數情況下，請保持在兩句話內敘述完畢。

當模板以整合狀態（例如放置在 {{multiple issues}} 中）或小型狀態（使用 |small=left 參數）顯示時，只有 issue 參數中的文字會顯示。例如在 {{citation style}} 模板中的參數設定為：

• |issue = 本條目的'''引用需要进行清理。'''
• | fix = 参考文献应符合正确的[[Wikipedia:列明来源|引用]]、[[Wikipedia:脚注|脚注]]及[[Wikipedia:外部链接|外部链接]]格式。

當單獨使用時顯示效果如下： Template:Citation style

但當與 {{article issues}} 模板整合使用或以小型模式（|small=left）顯示時，效果則如下： Template:Multiple issues Template:Citation style

talk

某些條目訊息框模板包含了一個通往其討論頁的連結，並讓編輯者能指定相關議題所在的章節位置。如要達成這項功能，請使用 talk 參數，使用方式為 |talk={{{talk|}}}。

這項參數將可被編輯者以下述方式使用：

• |talk=章節標題 - 連結可通往條目討論頁中的特定章節。例如：|talk=西瓜
• |talk=完整頁面名稱 - 連結將通往指定的頁面。例如：|talk=Talk:香蕉#西瓜

請注意：

• 當模板中使用本參數時，模板本身將會顯示一個通往討論頁的連結（為了顯示支援此功能），但僅有在參數被確實定義時才會在條目中的模板內顯示。
• 如果要讓模板永遠顯示一個通往討論頁的連結，請使用 |talk={{{talk|#}}} 參數。
• 如果討論頁面不存在，無論參數設定為何，都將不會顯示任何連結。

date

將 date 直接傳送至元模板可讓編輯者（或機器人）自行輸入模板被放置在條目中的日期。日期將會以較小的字體在主要文字後顯示。

在 cat 參數同時獲得定義時，將 date 參數傳送至元模板可實現將條目自動按月分類的功能。

time

time和date用法差不多，但是time可以配合{{#time:c}}，例如：

{{ambox|issue=内容|fix=附加文字|date={{subst:#time:c}}}}會顯示為：

{{ambox|issue=内容|fix=附加文字|time={{subst:#time:c}}}}會顯示為：

cat

這個參數定義了清理分類的名稱。使用 |cat=CATEGORY 參數：

• 並同時使用 |date=DATE，則條目會被自動分類至 Category:自DATE起CATEGORY 中。
• 若無指定日期，條目會被自動分類至 Category:CATEGORY 中。

all

all 參數可用來指定所有包含模板之條目的分類。

其他參數

右側方框內展示了此模版的所有參數。由於幾乎不可能同時用到所有參數，因此不建議複製此處的空白模版。

完整的所有參數

{{Ambox | name = | subst = <includeonly>{{subst:substcheck}}</includeonly> | small = {{{small|}}} | type = | image = | imageright = | smallimage = | smallimageright = | class = | style = | textstyle = | sect = {{{1|}}} | issue = | talk = {{{talk|}}} | fix = | date = {{{date|}}} | time = {{{time|}}} | text = | smalltext = | cat = | all = | cat2 = | all2 = | cat3 = | all3 = }}<noinclude> {{Documentation}} </noinclude>

imageright

在訊息框右側顯示圖片。填入方式與 image 參數相同，預設為不顯示任何圖片。

smallimage & smallimageright

可在此參數指定模板縮小顯示後所使用的圖片。僅在定義 |small=left 時有效。

class

可自行定義使用在訊息框的CSS型別選擇器（Class）。

style & textstyle

可選擇定義CSS樣式，不需加上引號 " "，但必須在結尾加上分號 ;。

• style 為套用至整個訊息框的樣式
• textstyle 為僅套用在文字上的樣式

text & smalltext

除了指定 issue 和 fix 參數外，也可使用 text 參數來定義要顯示的文字（不建議使用text，不支持行動版）

smalltext 則用來定義要以較小字體顯示的文字

其他分類相關參數

• cat2 和 cat3 可增加按月分類時所用的分類名稱，用法與 #cat 參數相同。
• all2 和 all3 可增加所有包含模板之條目的分類名稱，用法與 #all 參數相同。

技術細節

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

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

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

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

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

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

參見

其他屬於 {{mbox}} 家族的系列模板：

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

其他頁面：

• Akarin:條目訊息方塊－（提議中）建立條目訊息方塊時應遵循的格式指引。
• Akarin talk:條目訊息方塊－討論相關的事宜。