维基专题:紋章及旗幟/旗幟模板

以下會介紹模板的使用方法、參數、變種及原理等。有關改進、維護的請求請到討論頁。

生成指定名称旗帜的一个小图片。

举例：{{flagicon|France}} →

举例：{{flagicon|Japan}} →

生成指定名称旗帜的一个小图片，附加指向相关条目的维基链接。

举例：{{flag|United Kingdom}} →  英国

举例：{{flag|Thailand}} →  泰國

注意到这串维基代码序列：{{flagicon|name}} [[name]] 可以被（也应当被）替换为更简单的：{{flag|name}}。

與{{Flag}}模板相似，但在部分情況時可能更為實用（見下方範例）：

举例： {{flagcountry|ITA}} →  義大利

意大利的國家代碼（ITA）被用來產生正確的標誌和連結。在這種情況下，只要使用{{flag}}即可產生相同的結果，如{{flag|Italy}}。然而，{{Flagcountry}}可以用國家地區代碼為參數，因而便於包含在其他模板（例如Infobox系列模板）中。

举例： {{flagcountry|ITA|1861}} →  義大利

與第一個示例類似，但是使用旗幟變量參數來選擇歷史標誌圖像。請注意，其連結的條目是 [[義大利]].

举例： {{flagcountry|Kingdom of Italy}} →  意大利

在這個例子中，使用了一個不同的國家資料模板，以連結至另一個文章（[[Kingdom of Italy|Italy]]）。和{{flag|Kingdom of Italy}} →  義大利王國相比，在此例中雖然都顯示出「義大利王國」，然而於其他情況下，所顯示的文字可能不同。因此，該選用flagcountry或 flag取決於欲顯示的文字；而在所有其他方面，模板是相同的。

功能與{{flag}}模板相同，但使用此模板時文字不生成超連結，可用於不應該鏈接國名/地區名的情況（例如條目中可能出現過度連結的情況時）。

舉例： {{flagu|United States}} →  美国

许多国家也有单独的旗帜模板，以标准的三字母国家代码命名，为的是提供“快捷方式”作为标准模板的一个替代选择。这有利也有弊。一些国家代码（像“USA”）被广泛知晓，对应的快捷方式模板（如{{USA}}）提供了使用上的便利。但有些国家代码相对来说不太出名，因此，若国家名称给出全拼的话，维基标记（wiki markup）可能会更清楚。同时，快捷方式模板并不提供使用历史上的旗帜变体的能力（见下方的描述），因此灵活性也更小。举例：

• {{AFG}} →  阿富汗
• {{CUB}} →  古巴

有些国家使用非标准的缩写。举例：

• {{PRC}} →  中华人民共和国
• {{ENG}} →  英格兰
• {{TRNC}} →  北賽普勒斯
• {{UK}} →  英国

参见Wikipedia:國家及地區標示模板查看完整的列表。

實際上，上述各種模板的參數都儲存在同一個頁面，即Country data模板。例如{{flag|古巴}}（ 古巴）中的圖片和名稱都存於Template:Country data Cuba。

要參看所有Country data頁面，可以到Category:国家资料模板。

但需注意的是其中的頁面不一定是一個實際意義上的國家，很多時一些國際組織、地區與聯盟也會包含其中。本計劃由英語維基百科翻譯而來。當時他們所用的屬國家模板之下，後來發覺問題時（更好的名稱可以是旗幟資料模板。）卻已太遲。

一些非國家的國家資料模板例子：

• {{flag|United Nations}} →  联合国
• {{flag|European Union}} →  欧洲联盟
• {{flag|Bavaria}} →  巴伐利亚

當然，國家資料模板也不會只包括現在，亦含過去的國家。

例子有：

• {{flag|Austria-Hungary}} →  奥匈帝国
• {{flag|Nazi Germany}} →  納粹德國

另外，請不要在國家資料模板內加入未來的國家。可以參考這裡。

為了方便使用，我們可以為許多旗幟增加“別名”，通常是三個字母的國家代碼及中文名稱。例如你可以不用{{flagicon|United States}}，而使用更簡單的{{flagicon|USA}}來造出。

大部分三字母國家代碼都可以在以下三個頁面中找到：ISO 3166-1 alpha-3、國際奧委會國家或地區編碼列表及国际足联国家代码列表。例如{{flagicon|DEU}}（國際奧委會）與{{flagicon|GER}}（國際奧委會及國際足總）都可以造出。當然一些非三字母的簡寫亦可接受，但該簡寫應較為著名及常用，如UK、EU及USSR。

這些別名在國家資料模板中只是一個重定向。例如Template:Country data FRA會重定向至Template:Country data France。這些別名亦會列於主國家資料模板中。

請不要為罕見的縮寫創建重定向，特別是一些沒有標準國家代碼的國家或地區。有時候有些有編號的國家都不一定著名！

英語版中，使用flag的話連結會顯示成輸入的文字。但中文版有所不同。

• {{flag|USA}} →  USA
• {{flag|UK}} →  UK
• {{flag|ROC}} →  ROC
• {{flag|TRNC}} →  TRNC

• {{flag|USA}} →  美国
• {{flag|UK}} →  英国
• {{flag|ROC}} →  中華民國
• {{flag|TRNC}} →  北賽普勒斯

許多國家在悠長的歷史中多次轉換其旗幟，而我們很難將每面旗幟都配上一模板。因此，國家資料模板內可以存儲不同的旗幟變種。只要在國家資料模板內存儲了旗幟變種，使用時只要額外指定一個參數，就能選擇特定的已存旗幟變種。要在國家資料模板內加上旗幟變種，就可以使用第二順位的variant參數。

例子：

• {{flag|Germany|empire}} →  德国
• {{flag|Germany|variant=empire}} →  德国
  • 與正常相比 →  德国
• {{flagcountry|CAN|1921}} →  加拿大
• {{flagicon|CAN|1921}} →
  • 與正常相比 →  加拿大

每個可用的變種都放置於國家資料模板之內，要使用時可在內查看。每個變種都會有段小句（如empire或1921）作為其副名稱。通常情況下小句都是旗幟開始使用的那一年，但其並不強制。

除非你肯定沒有任何頁面正在使用該變種，否則不要更改其名稱。原因是旗幟變種不會像主頁面一樣在更改後會自動獲得重定向頁。更改旗幟變種的名字，將會立即中斷任何正使用該變種的頁面。不過，當然也有解決辦法： 先創立一個使用相同圖片的變種（使用你想改成的名字） 手動將每個連入改變至新變種，注意亦需把舊變種的重定向亦重新定向至新變種。 最後再刪除舊變種，之前切記再檢查有否遺留。

旗幟的原設定大小為22x20px，再加上有一個像素厚的邊框，即旗幟高度不能超過20像素，寬度亦不能超過22像素。由於大多數旗幟都是水平向，所以有22像素限制的通常是寬度。這尺寸經過仔細挑選，認為其最能配合普遍的文字大小。

要改變上述設定，就需要使用到size參數，這種參數不需要預先在國家資料模板中存放。

例子有：

• {{flag|MAC|colonial|size=50px}} →  澳門
• {{flagicon|HK|size=50px}} →
• <big>{{flag|ROC|size=100px}}</big> →  中華民國
• {{flagicon|Brazil|size=12px}} →
• <small>{{flag|Italy|size=18px}}</small> →  義大利

正常情況下，{{flag}}會自動建立一個連結，但我們可以用name參數來將其改變。

與flagcountry相似，但可以擴展其後續連結。這模板主要用於某一主題中的國家名單。

例子如下：

• {{flaglink|Serbia|歷史}} → 塞爾維亞
• {{flaglink|USSR|軍事}} → 苏联

但要注意的是Flaglink只能增加連結的後部分，這對中文版來說有些不利。

與flaglink相似，但可以擴展其前後連結。

例子如下：

• {{flag+link||Serbia|歷史}} →  塞尔维亚
• {{flag+link|在日|VNM|人}} →  越南
• {{flag+link|波蘭裔|HTI|人}} →  海地

(※)注意：此模板引入後未經充分測試。請謹慎使用。

仅生成旗帜图片，不附带任何链接。

例子如下：

• {{flagicon image|Flag of Russia.svg}} →

我們可以事先把海軍的旗幟放到國家資料模板（使用naval），再用Navy模板將其喚出來，連結也會自動指向其海軍頁面。

例子如下：

• {{navy|UK}} →  英國皇家海軍
• {{navy|Nazi Germany}} →  納粹德國海軍
• {{navy|USSR}} →  蘇聯海軍
• {{navy|ROC}} →  中華民國
• {{navy|Kingdom of Prussia}} →  普魯士海軍

例子如下：

• {{army|UK}} →  英國陸軍
• {{army|US}} →  美国陆军
• {{army|ROC}} →  中華民國

例子如下：

• {{Air force|UK}} →  英國皇家空軍
• {{Air force|Nazi Germany}} →  納粹德國空軍
• {{Air force|US}} →  美国空军
• {{Air force|ROC}} →  中華民國

例子如下：

• {{Armed forces|East Timor}} →  东帝汶国防军
• {{Armed forces|USA}} →  美国武装部队
• {{Armed forces|Papal States}} →  教宗国军
• {{Armed forces|Korean Empire}} →  大韩帝国军

例子如下：

• {{Military police|Israel}} →  以色列憲兵
• {{Military police|JPN}} →  日本
• {{Military police|ROC}} →  中華民國
• {{Military police|VAT}} →  梵蒂冈
• {{Military police|烏克蘭}} →  烏克蘭
• {{Military police|Paraná}} →  巴拉那州

例子如下：

• {{gendarmerie|ARG}} →  阿根廷
• {{gendarmerie|MEX}} →  墨西哥
• {{gendarmerie|FRA}} →  法國國家憲兵

例子如下：

• {{Marines|ROC}} →  中華民國
• {{Marines|Philippines}} →  菲律賓
• {{Marines|THA}} →  泰國

例子如下：

• {{Space force|Russia}} →  俄羅斯
• {{Space force|USA}} →  美國太空軍

例子如下：

• {{Coast guard|CAN}} →  加拿大海岸警卫队
• {{Coast guard|USA}} →  美国海岸警卫队
• {{Coast guard|MDV}} →  馬爾地夫
• {{Coast guard|Myanmar}} →  緬甸

例子如下：

• {{Air defence force|USSR}} →  苏联防空軍
• {{Air defence force|Myanmar}} →  緬甸

例子如下：

• {{Border guard|USSR}} →  苏联邊防軍
• {{Border guard|Bangladesh}} →  孟加拉国
• {{Border guard|SFR Yugoslavia}} →  南斯拉夫社會主義聯邦共和國
• {{Border guard|East Germany}} →  德意志民主共和国边防军
• {{Border guard|Russia}} →  俄羅斯

例子如下：

• {{rocket force|PRC}} →  中华人民共和国
• {{rocket force|Saudi Arabia}} →  沙烏地阿拉伯
• {{rocket force|RUS}} →  俄羅斯
• {{rocket force|Union of Soviet Socialist Republics}} →  苏联

生成一块相当于一面旗帜大小的空白。用于没有合适旗帜可以使用，又需要与其他文字对齐的场合。

維基百科上使用國家運動隊的旗幟可算是最常見的例子之一。有好幾套已制定的體育可以使用此旗幟模板系統：

這些模板使用簡稱的原因是它們很可能會在一場賽事裡多次出現。這些模板亦完全取代了以前曾使用的國家隊模板。例如{{fb|ITA}}取代了{{ITAf}}、{{ru|NZL}}代替{{NZLru}}等。

這些體育項目有時會有一些變種：

• "u"作為後綴會加上「歲以下」，但注意此模板為歲數參數在前。
• "w"作為後綴代表使用女子組模板。
• "-rt"作為後綴則將旗幟在後，文字在前。
• "-big"作為後綴會將旗幟放大，再將名字放在旗幟下方。比賽結果表中經常使用這種風格的旗幟。

注意不要直接使用此模板產生的連接來創建條目，其很可能包括繁體及簡體。例如下方的荷兰21歲以下國家女子足球隊。

以足球為例子，可用的模板如下：

隊伍	正常		靠右	加大
男子組	Template:fb	Template:fbu	Template:fb-rt	Template:fb-big
例子	義大利	阿尔巴尼亚	法國	義大利
女子組	Template:fbw	Template:fbwu	Template:fbw-rt	Template:fbw-big
例子	德国	荷蘭	英格兰	德国

旗幟模板系統共使用了三種不同模板，每一種都有不同功能：

1. 用戶自己加入的模板
2. 國家資料模板（內部）
3. 格式模板（內部）

例如{{flag|Spain}}就使用了：

1. Template:Flag，設定旗幟名稱、變種、大小、連結到及顯示名稱等；
2. Template:Country data Spain，提供各種所需資料；
3. Template:Flag/core，實際指定旗幟圖像及連結。

此系統架構意味著：

• 所有國家的具體數據都包含在個別的國家資料模板內，提高維護效率；
• 格式只集中在極少數的模板，確保了版面一致性。

每次使用旗幟模板都會經過三個步驟。以上述的例子－{{flag|Spain}}－來說，其有這些步驟：

首先，Template:Flag會展開來使用Template:Country data Spain，並確定所有用戶有指定的參數設置。模板的首個參數為「名字」。其用來指定{{flag}}將使用哪一個國家資料模板。所以你會輸入：

{{flag|Spain}}

然後，模板擴展開來：

{{country data Spain | Flag/core | variant = | size = | name = Spain}}

如有variant、size或name參數出現，則亦會擴展開來。例如{{flag|Spain|1939|name=España}}會出現如下：

{{country data Spain | Flag/core | variant = 1939 | size = | name = España}}

接著，國家資料模板亦會展開，配上已提供的參數。繼續我們的{{flag|Spain}}，會出現：

{{Flag/core | alias = 西班牙 | flag alias = Flag of Spain.svg | name = España}}

再由Flag/core調出以下產品：

[[File:Flag of Spain.svg|22x20px|border|Flag of Spain]] [[西班牙|España]]

亦即選擇上方任一語法都可出現 España。

所有國家資料模板結構都有如下標準模式，再另外加上額外參數。

國家資料模板的空樣板如下：

{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = <名字>
| flag alias = <圖片>
| size = {{{size|}}}
| name = {{#if: {{{name|}}} | {{{name|}}} | <名字> }}
}}

這裡你會發現有兩個基本參數必須指定：

1. alias參數來指定國家名稱；
2. flag alias參數來指定使用哪一張圖片。

country showdata模板會於編輯後自動出現，但要注意由於它們並不是同一模板，所以必需先儲存好編輯系統才會更新頁面。關於country showdata我們稍後會再討論。

size = {{{size|}}}及name = {{#if: {{{name|}}} | {{{name|}}} | }}參數用於保證所有用戶設定的參數（variant、name等）都會經過最外層模板，即flag與flagicon等。刪除這些參數將禁用variant、name等功能。

謹記如圖片屬合理使用時則絕不可誤入模板內！此時應用File:Flag placeholder.svg代替。

若要加入字詞轉換請於 | name 中加入，如| name = {{#if: {{{name|}}} | {{{name|}}} | -{zh-cn:贝宁;zh-tw:貝南}- }}。

要增加旗幟變種，就要使用到flag alias參數。其獨特標籤為flag alias-變種名字（不要忘記加上-）。例如Template:Country data Mexico就有好幾個變種，其中有一個參數是：

| flag alias-1934 = Flag of Mexico (1934-1968).png

所以，當指定了{{flag|Mexico|1934}}，File:Flag of Mexico (1934-1968).png就會呈現出來。旗幟變種的選擇會同時在格式模板上顯示。

國家資料模板除了默認旗幟之外，至少會有一個旗幟變種，即必須有以下此行：

| variant = {{{variant|}}} 

就像size與name參數，變種參數也需要從外層模板走到內層格式模板。遺漏上述一行將導致旗幟變種選擇失敗。由於此參數不涉及外觀問題，因此其必須像size參數保持原始設定。

最簡單改變連結文字的方法是用{{Flagicon}}：

{{flagicon|HKG}} [[HKG]]

就會出現 HKG。

現在，我們亦可以使用name參數來改變顯示文字：

{{flag|HKG|name=HKG}}

就會出現 HKG了。

Any country data template that will be used with a national team template must include an additional "pass-through" parameter:所有有包含國家隊參數的國家資料模板必須加上一個額外的“直通”參數：

| altlink = {{{altlink|}}}

此參數是為連結連結產生合適後綴。例如Template:bk會增加“國家男子籃球隊”到國家名之後，這動作需要altlink參數。

在大多數情況下，國家隊的旗幟和顯示名稱都會對應其常用的旗幟及名稱。然而，在某些情況下，我們甚至可以通過通過附加參數來覆蓋國家資料模板。默認連結也可在全名不常用的情況下改變。

國家資料模板會自動使用Template:Country showdata來弄出一個模板文檔。現請回想一下每個國家資料模板的第一行都有甚麼？答案：

{{{1<noinclude>|country showdata</noinclude>}}}

正常來說，如果這個國家模板只包含alias、flag alias、size和name的話，就不需要加上任何其它模板。但當你一加上如旗幟變種、別名等副參數時，就需要為var、redir等參數加上<noinclude>。例子如下：

<noinclude>
| var1 = ...
| redir1 = ...
| related1 = ...
</noinclude>

另外，連去不同語言時亦需要加上<noinclude>。看看下面：

<noinclude>
[[en:Template:Country data United States]]
</noinclude>

如想獲得更多關於Template:Country showdata的信息，請參考Template:Country showdata/doc。

• {{flagIOC}}={{AY}}用途相似，但專用於奧運會代表團。如： 澳大利亚
• {{Shipboxflag}}，用於船用旗幟。
• 模板:CHN-all，中國歷年旗幟。
• 模板:ROC-all，中華民國歷年旗幟。
• 模板:TWN-all，臺灣歷年旗幟。
• 模板:HKG-all，香港歷年旗幟。
• 模板:MAC-all，澳門歷年旗幟。
• 模板:MNG-all，蒙古歷年旗幟。

• {{WikiProject Flag Template}} – 用於專題相關的頁面或用戶頁。