模板:WPBannerMeta/doc
此頁面是Template:WPBannerMeta的模板文件。 此頁面可能包含了模板的使用說明、分類和其他內容。 |
此模板文件被引用於約671,000個頁面,佔全部頁面的9%。 為了避免造成大規模的影響,所有對此模板文件的編輯應先於沙盒、測試樣例或您的沙盒上測試。 測試後無誤的版本可以一次性地加入此模板文件中,但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
有機械人使用本模板文件
如欲移動、刪除或修改此模板文件而無法向下相容,並會影響機械人運作,請先通知機械人操作者,謝謝您。相關的機械人:User:Cewbot/log/20200122/configuration |
WPBannerMeta是一個元模板,能用來建立專題橫幅,能方便地在條目討論頁建立橫幅,從而使每個專題協調工作。所有使用該模板的橫幅列表見連入頁面:WPBannerMeta
該模板為元模板,用途為構建其他模板。因此請不要在討論頁直接使用此模板,而是透過專題模板調用。
語法
| ||
|
WPBannerMeta能以不同的複雜度使用,既可很簡單也可極複雜。簡單的選項在此先行列出,而其餘複雜的內容則在頁面下方。
WPBannerMeta使用兩類不同的參數,分別是格式和顯示參數。格式參數可為特定專題自訂本元模板,用於定義連結目標、分類、圖像和文字。所有格式參數均使用大寫字母,並用底線(_)代替空格(例如|PROJECT=
和|NOTE_1_CAT=
)。顯示參數則為橫幅所在的單個條目定義其模板輸出,這些參數會出現在條目討論頁(|class=
,|importance=
等),並且在底層必須由專題橫幅「傳遞」到元模板。為傳遞參數foo
,則需要包含代碼foo={{{foo|}}}
。
下文將以當前並不存在的鬱金香主題與鬱金香專題為例介紹專題橫幅的構建。
簡單選項
PROJECT
(專題,必填)– 專題名稱,不含「專題」二字。例如:郁金香
substcheck
(替換引用檢查)– 該參數允許模板偵測其是否誤被替換引用,而非內嵌於頁面,並會給出錯誤訊息。substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly>
small
(微型,必填) – 尺寸參數必須傳遞至模板以正確顯示。例如:small={{{small|}}}
category
(分類,必填)– 「category」參數必須傳遞至模板。例如:category={{{category|¬}}}
。category_trad
(分類是否為繁體)–當「PROJECT
」參數以繁體中文填寫時,請指定該參數為yes
,確保條目評級分類不會繁簡混雜。
listas
(列為,必填)– 「listas」參數必須傳遞至模板。例如:listas={{{listas|}}}
(橫幅名稱,必填)– 橫幅頁面的全名。例如:BANNER_NAME={{subst:FULLPAGENAME}}
Template:WikiProject Tulips
PROJECT_LINK
(專題連結)– 模板預設專題位於"专题:<PROJECT>"
。若屬其他情況,請在此參數定義專題頁的完整連結。例如:专题:郁金香
IMAGE_LEFT
(左側圖像)– 橫幅左上角的圖像地址,請勿加入「'File:」或「File:」字首。專題橫幅使用的圖像必須是自由圖像,不得使用合理使用圖像。例如:Tulipa suaveolens floriade to Canberra.jpg
IMAGE_LEFT_SMALL
(左側小圖)– 橫幅以「微型」顯示時的IMAGE_LEFT
的圖片大小,預設為40px。例如:25px
IMAGE_LEFT_LARGE
(左側大圖)– 通常顯示的IMAGE_LEFT
圖片大小,預設為80px。例如:50px
IMAGE_RIGHT
(右側圖像)– 橫幅右上角的圖像地址,請勿加入「'File:」或「File:」字首。專題橫幅使用的圖像必須是自由圖像,不得使用合理使用圖像。例如:Tulipa suaveolens floriade to Canberra.jpg
IMAGE_RIGHT_SMALL
(右側小圖)– 橫幅以「微型」顯示時的IMAGE_RIGHT
的圖片大小,預設為40px。例如:25px
IMAGE_RIGHT_LARGE
(右側大圖)– 通常顯示的IMAGE_RIGHT
圖片大小,預設為80px。例如:50px
MAIN_TEXT
(主文字)– 預設文字為「本條目屬於[[{{{PROJECT}}}专题]]的範疇,一個旨在改善中文維基百科{{{PROJECT或MAIN_ARTICLE}}}類條目內容的專案。如果您有意參與,請瀏覽專題首頁,參與其[[Talk:{{{PROJECT_LINK}}}]]並完成相應的開放性任務。」定義本參數則可顯示其他文字。PORTAL
(主題)– 若該專題包含有主題,請為此參數定義主題名。例如:郁金香
PORTAL_IMG
(主題圖像)– 預設為「拼圖」圖示,可定義此參數換用其他圖像。 例如:Icon tools.svg。
MAIN_CAT
(主分類)– 預設不建立主分類,若定義該參數,所有顯示該模板的頁面都將歸入Category:MAIN_CAT
。例如:郁金香专题条目
→ Category:鬱金香專題條目BOTTOM_TEXT
(底文字)– 若定義此項,文字將顯示在橫幅底部、摺疊區(若顯示)上端。請勿使用此參數掛接其他代碼到模板底部,請參見下文勾點一節尋求更好的解決辦法。
- 範例
{{WPBannerMeta |PROJECT = 郁金香 |BANNER_NAME = Template:WikiProject Tulips |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly> |small={{{small|}}} |category={{{category|¬}}} |listas={{{listas|}}} |PROJECT_LINK = 专题:郁金香 |IMAGE_LEFT = Tulipa suaveolens floriade to Canberra.jpg |IMAGE_LEFT_SMALL = 25px |IMAGE_LEFT_LARGE = 50px |MAIN_ARTICLE = [[郁金香]]及[[百合科]]相关条目 |PORTAL = 郁金香 |PORTAL_IMG = Tulipa florenskyi 4.jpg }} |
- 顯示為:
鬱金香專題 | (獲評非條目級) | |||||||
---|---|---|---|---|---|---|---|---|
|
評級
許多專題使用條目質素評級標準評價其條目質素,並使用條目重要度評級標準為其排定優先級。為了讓專題委員會及各專題使用機械人編制條目狀態表,您需要遵守/使用機械人指南,並掌握下列要點:
QUALITY_SCALE
(質素評級標準)– 用於組態質素評級標準,可選項有:class
(等級,必填)– 若使用質素標準,class參數必須傳遞至元模板。例如:class={{{class|}}}
auto
(自動)若需要自動評級選項,auto參數必須傳遞至元模板。例如:auto={{{auto|}}}
使用機械人自動為小作品分類的專題,可令機械人在其專題橫幅加入|auto=yes
,橫幅即可提示該條目係由機械人自動評級。AUTO_ASSESS_CAT
(自動評級分類)–若定義該參數,所有包含|auto=
參數的條目均會歸入Category:AUTO_ASSESS_CAT
。預設歸類至Category:自動評級PROJECT
條目。例如:自动评级郁金香和水仙条目
→ Category:自動評級鬱金香和水仙條目
B_CHECKLIST
(乙級檢查表)– 若定義此項,即可啟用乙級檢查表。乙級條目官方描述包含六項指標,各條目對各項標準的符合/不符狀態透過|b1=
至|b6=
加以傳遞。僅當某條目六項均達標時方可評為乙級,否則則為丙級。b#
– 若使用乙級檢查表,六項乙級指標必須傳遞至元模板。- 若使用自訂等級,必須將標準參數傳遞至元模板。例如:
b1={{{B-Class-1|{{{b1|}}}}}}
等。 - 若使用標準參數,則例如:
b1={{{b1|}}}
等即可。
- 若使用自訂等級,必須將標準參數傳遞至元模板。例如:
importance
(重要度)– 若定義此項,即可啟用重要度評級標準(極高、高、中、低、極低、無、不適用、未知)。例如:importance={{{importance|}}}
priority
(優先級)– 若定義此項,即可啟用優先級評級標準(極高、高、中、低、不適用、未知)。例如:priority={{{priority|}}}
。importance、priority二參數只可用其一。IMPORTANCE_SCALE
- standard(標準)– 使用標準評級標準。本項為預設。
- inline(行內)– 允許使用簡單的自訂質素標準,通常搭配{{Class mask}}使用。
- subpage(子頁面)– 允許使用更複雜的自訂質素標準,需建立名為「/importance」的子頁面。詳見自訂遮罩。
ASSESSMENT_LINK
(評級連結)– 特定專題質素(和/或重要度)評級標準的連結,若存在"专题: <PROJECTLINK>/评级"
頁面,則該頁即為預設連結。若需指定其他頁面,可將該參數設為no。詳見此處。ASSESSMENT_CAT
(評級分類)– 條目會根據其質素等級歸入相應分類,因此鬱金香「特色條目」預設會歸類至Category:特色級鬱金香條目。若定義該參數,特色條目則會改歸類至Category:特色級ASSESSMENT_CAT
. 例如:百合科条目
→ Category:特色級百合科條目COMMENTS
(評論)– 部分專題可能希望使用條目討論頁的子頁面為該條目填寫簡單的評級相關評論,若評論位於「{{FULLPAGENAME}}/评论
」子頁面,則該參數會自動在橫幅提示評論頁存在與否。例如:yes
COMMENTS_CAT
(評論分類)– 若定義此項,含有評論頁的條目會歸入Category:COMMENTS_CAT
。頁面預設會歸入含有評論頁的PROJECT條目。例如:(可選)含有评论页的郁金香和水仙条目
→ Category:含有評論頁的鬱金香和水仙條目。使用none
值則不會歸類。COMMENTS_FORCE
(強制評論)– 預設情況下,評論子頁面不存在時並不會顯示訊息。若定義該參數,則會顯示訊息要求評級者建立評論頁。例如:yes
- 範例
{{WPBannerMeta |PROJECT = 郁金香 |BANNER_NAME = Template:郁金香专题 |small={{{small|}}} |category={{{category|¬}}} |listas={{{listas|}}} |IMAGE_LEFT = Tulipa suaveolens floriade to Canberra.jpg |QUALITY_SCALE = extended |class={{{class|}}} |auto={{{auto|}}} |importance={{{importance|}}} |ASSESSMENT_LINK = 专题:郁金香/条目评级 |COMMENTS = yes |COMMENTS_CAT = |COMMENTS_FORCE = yes }} |
- 顯示為:
鬱金香專題 | (獲評模板級、不適用重要度) | |||||||
---|---|---|---|---|---|---|---|---|
|
警報與提示
WPBannerMeta能顯示許多包含條目資訊和其相關工作群組的的欄位,並預設有「attention」欄位供標記需要立即受到關注的條目,以及「needs-infobox」欄位供標記需要資訊框的條目。
attention
(關注)– 請傳遞該參數以啟用相關提示。例如:attention={{{attention|}}}
,然後在相關討論頁加入|attention=yes
。ATTENTION_CAT
(關注分類)– 若定義該項,所有顯示關注提示的條目都將歸類至Category:ATTENTION_CAT
。預設情況下,條目會歸入Category:需要關注的PROJECT
條目。例如:需要关注的原种郁金香工作组条目
→ Category:需要關注的原種鬱金香工作群組條目。使用none
值則不會歸類。
infobox
(資訊框)– 請傳遞該參數以啟用相關提示。例如:infobox={{{needs-infobox|}}}
,然後在相關討論頁加入|needs-infobox=yes
。INFOBOX_CAT
(資訊框分類)–若定義該項,所有顯示需要資訊框提示的條目都將歸類至Category:INFOBOX_CAT
。預設情況下,條目會歸入Category:需要資訊框的PROJECT
條目。例如:需要信息框的原种郁金香工作组条目
→ Category:需要資訊框的原種鬱金香工作群組條目。使用none
值則不會歸類。
note 1
(提示1)–請傳遞該參數以定義任意提示。例如:note 1={{{needs-photo|}}}
,然後在相關討論頁加入|needs-photo=yes
。橫幅核心內最多可定義10個提示資訊。NOTE_1_TEXT
(提示1文字,必填)– 提示1的文字。例如:根據標記,本條目需要相片。NOTE_1_IMAGE
(提示1圖像)– 每個提示均可指定一幅圖像,請謹記必須使用自由圖像,而非合理使用圖像。例如:Gnome-dev-camera.svg
NOTE_1_FORMAT
(提示1格式)– 註釋表格的可選格式(如顏色等)例如:style="background:blue"
NOTE_1_CAT
(提示1分類)–若定義此項,所有顯示提示1的條目均會歸入Category:NOTE_1_CAT
。例如:需要照片的郁金香条目
→ Category:需要相片的鬱金香條目
COLLAPSED
(可否摺疊)–當顯示在頁面的註釋和警報多於某一臨界值時,便會自動摺疊隱藏。設置本參數即可自訂該臨界值,確定頁面上不會引發摺疊的提示的最大數量。預設為3,所以如果頁面上有三條提示,此時提示區並不會摺疊,但如果顯示出第四條便會出現摺疊框。因此若設置|COLLAPSED=0
,便能使提示區始終摺疊,而設置|COLLAPSED=999
則可使其永不摺疊。請參見/notecounter hook。例如:6
- 範例
{{WPBannerMeta |PROJECT = 鬱金香 |BANNER_NAME = Template:WikiProject Tulips |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly> |small={{{small|}}} |category=no |listas={{{listas|}}} |IMAGE_LEFT = Tulipa suaveolens floriade to Canberra.jpg |QUALITY_SCALE = extended |class={{{class|}}} |ASSESSMENT_LINK = 專題:鬱金香/條目評級 |attention={{{attention|}}} |ATTENTION_CAT = |infobox={{{needs-infobox|}}} |INFOBOX_CAT = |note 1={{{needs-photo|}}} |NOTE_1_TEXT = 根據標記,本條目需要[[相片]]。 |NOTE_1_IMAGE = Gnome-dev-camera.svg |NOTE_1_FORMAT = style="background:blue" |NOTE_1_CAT = 需要相片的鬱金香條目 |note 2 = {{{audio-file|}}} |NOTE_2_TEXT = 本條目含有對應[[音頻檔格式|音訊檔案]]。 |NOTE_2_IMAGE = Nuvola apps arts.svg |NOTE_2_CAT = 含音頻檔的鬱金香條目 }} |
- 顯示為:
鬱金香專題 | (獲評丙級) | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
工作群組
WPBannerMeta最多能容納五個工作群組,每個都可以擁有自己的圖像、連結和重要度評級標準。下列參數可用:
tf 1
(工作群組1)– 必須傳遞該參數以啟用工作群組的功能和資訊顯示。 例如:tf 1={{{floridiae|}}}
TF_1_LINK
(工作群組1連結)– 工作群組專題頁面的完整名稱。例如:专题:郁金香/工作组/原种郁金香
TF_1_NAME
(工作群組1名稱)– 該工作群組在內部連結上所顯示的名稱,若使用|TF_1_TEXT=
則無需此參數。 例如:原种郁金香工作组
TF_1_NESTED
(工作群組1巢狀)– 若定義此項,則當該橫幅摺疊在{{WikiProjectBannerShell}}內時,形如「/ [[{{{TF_1_LINK}}}|{{{TF_1_NESTED}}}]]」的連結會加入在主專題名之後。例如:原种郁金香
TF_1_TEXT
(工作群組1文字)– 若定義此項,可替換預設「本條目由……提供支持" 文字。例如:本页面属于[[专题:郁金香/工作组/原种郁金香|原种郁金香工作组]]的范畴,欢迎新成员加入!
TF_1_IMAGE
(工作群組1圖像)– 可為每個工作群組指定圖像,請謹記必須使用自由圖像,而非合理使用圖像。 例如:Tulipa florenskyi 4.jpg
TF_1_SIZE
(工作群組1尺寸)– 圖像尺寸可在此處指定,預設為30px。使用比|IMAGE_LEFT_LARGE=
還要大的尺寸還出現一些……很有趣的……結果。例如:40px
TF_1_QUALITY
(工作群組1質素)– 若定義此項,即可為該特譴隊啟用與主專題相同的質素評級分類(例如:Category:特色級鬱金香條目)。評級由|class=
產生,並使用|QUALITY_SCALE=
。例如:yes
tf 1 importance
(工作群組1重要度)– 若定義此項,即可為該特譴隊啟用單獨的重要度(或優先級)評級標準。例如:tf 1 importance={{{原种郁金香-importance|}}}
TF_1_ASSESSMENT_CAT
(工作群組1評級分類,若啟用評級則必填)– 用於該工作群組專門的質素和重要評級的分類,語法與|ASSESSMENT_CAT=
相同。例如:原种郁金香条目
→ Category:特色級原種鬱金香條目tf_1_category_trad
(工作群組1分類是否為繁體)– 若TF_1_ASSESSMENT_CAT
使用繁體中文,請指定該參數為yes
,確保工作群組評級分類不會繁簡混雜。
TF_1_MAIN_CAT
(工作群組1主分類)– 若定義此項,所有顯示「工作群組1」的頁面均會歸入Category:TF_1_MAIN_CAT
。例如:原种郁金香条目
→ Category:原種鬱金香條目
- 範例
{{WPBannerMeta |PROJECT = 郁金香 |BANNER_NAME = Template:郁金香专题 |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly> |small={{{small|}}} |category={{{category|¬}}} |listas={{{listas|}}} |IMAGE_LEFT = Tulipa suaveolens floriade to Canberra.jpg |QUALITY_SCALE = standard |class={{{class|}}} |tf 1={{{floridiae|}}} |TF_1_LINK = 专题:郁金香/工作组/原种郁金香 |TF_1_NAME = 原种郁金香工作组 |TF_1_NESTED = 原种郁金香 |TF_1_TEXT = |TF_1_IMAGE = Tulipa florenskyi 4.jpg |tf 1 importance={{{floridiae-importance}}} |TF_1_ASSESSMENT_CAT = 原种郁金香条目 |TF_1_MAIN_CAT = 原种郁金香条目 }} |
- 顯示為:
本模板文件屬於下列維基專題範疇: | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
進階功能
勾點
WPBannerMeta含有許多「勾點」,可提供更多進階和自訂功能。各子模板會傳遞至關聯勾點參數,任何關聯參數都應再傳遞至勾點模板——可能需要重複已經傳遞至主模板的參數(通常用 (|category={{{category|¬}}}
和|class={{{class|}}}
)。如果您認為您寫的勾點可能會被其他專題用到,請將其複製或移動至Template:WPBannerMeta/hooks的子頁面,並加入到該頁的列表中。
自訂遮罩
WPBannerMeta使用遮罩規範化|class=
參數的值,以過濾無效輸入(如|class=燒餅
),並使類似的輸入等效化(如|class=FA
和|class=特色
)。本遮罩能有效控制可接受哪些擴充等級標準值(如「模板級」、「重新導向級」等)。希望使用其他等級(如「未來級」、「乙+級」),或不想使用全部標準等級(如不用「丙級」)的專題也可以指定自己的自訂遮罩。
其他細節
本元模板會自動將所有實例(即特定的專題橫幅)歸入Category:專題橫幅,因此無需在其文件中為各專題橫幅加入分類。
WPBannerMeta模板核心:
為降低未使用到WPBannerMeta全部功能的橫幅的位元組數,大部分可選功能均被拆分至各子頁面:
- Template:WPBannerMeta/class – 規範化
|class=
輸入的遮罩 - Template:WPBannerMeta/comments – 當定義
|COMMENTS=yes
時顯示的訊息 - Template:WPBannerMeta/importancescale – 重要度評級系統
- Template:WPBannerMeta/warnings – 誤植模板時顯示的警告
- Template:WPBannerMeta/note – 單獨的提示
- Template:WPBannerMeta/qualityscale – 質素評級系統
- Template:WPBannerMeta/taskforce – 顯示各工作群組
- Template:WPBannerMeta/templatepage – 僅在模板頁顯示的分類和提示
參見
- Template:Class mask – WPBannerMeta的預設質素等級遮罩