使用說明:旗幟模板

此處關注於旗幟模板，詳見旗幟模板系統。

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

主要模板

Template:Flagicon

生成指定名稱旗幟的一個小圖片。

舉例：{{flagicon|France}} →

舉例：{{flagicon|Japan}} →

Template:Flag

生成指定名稱旗幟的一個小圖片，附加指向相關條目的內部連結。

舉例：{{flag|United Kingdom}} → 英國

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

可以被（也應當被）替換為更簡單的：模板链接：{{flag|name}}。

Template:Flagcountry

與模板連結：{{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取決於欲顯示的文字；而在所有其他方面，模板是相同的。

Template:Flagu

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

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

「捷徑」旗幟模板

許多國家也有單獨的旗幟模板，以標準的三字母國家代碼命名，為的是提供「捷徑」作為標準模板的一個替代選擇。這有利也有弊。一些國家代碼（像「USA」）被廣泛知曉，對應的捷徑模板（如模板連結：{{USA}}）提供了使用上的便利。但有些國家代碼相對來說不太出名，因此，若國家名稱給出全拼的話，Wiki標記（wiki markup）可能會更清楚。同時，捷徑模板並不提供使用歷史上的旗幟變體的能力（見下方的描述），因此靈活性也更小。

舉例：{{AFG}} → 阿富汗

舉例：{{PRC}} → 中國

舉例：{{CHN}} → 中國

參見國家及地區標示模板列表。

主旗幟名稱

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

要參看所有Country data頁面，可以到分類:地區資料模板。

但需注意的是其中的頁面不一定是一個實際意義上的國家（Country），很多時一些國際組織、地區與聯盟也會包含其中。本計劃由英語維基百科翻譯而來。本計劃中文名已改為「地區資料模板」，唯英文名仍為「Country data」。

地區資料模板中包含一些國際組織、聯盟和非國家地區：

• {{flag|United Nations}} → 聯合國
• {{flag|European Union}} → 歐洲聯盟
• {{flag|Macao}} → 中國澳門

當然，地區資料模板也包含已消亡或解散的國家以及國際組織、聯盟和非國家地區。

例子有：

• {{flag|Austria-Hungary}} → 奧匈帝國
• {{flag|Soviet Union}} → 蘇聯

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

別名

為了方便使用，我們可以為許多旗幟增加「別名」，通常是三個字母的國家代碼及中文名稱。例如你可以不用{{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|CHN}} → CHN

中文版

• {{flag|USA}} → 美國
• {{flag|UK}} → 英國
• {{flag|CHN}} → 中國

旗幟變種

許多國家在悠長的歷史中多次轉換其旗幟，而我們很難將每面旗幟都配上一模板。因此，地區資料模板內可以存儲不同的旗幟變種。只要在地區資料模板內存儲了旗幟變種，使用時只要額外指定一個參數，就能選擇特定的已存旗幟變種。要在地區資料模板內加上旗幟變種，就可以使用第二順位的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=100px}} → 中國澳門
• {{flagicon|HK|size=100px}} →
• {{flagicon|Brazil|size=10px}} →
• <small>{{flag|Italy|size=15px}}</small> → 義大利

名稱

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

其它旗幟模板

Template:Flaglink

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

例子如下：

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

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

Template:Flagicon image

僅生成旗幟圖片，不附帶任何連結。

例子如下：

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

Template:Navy

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

例子如下：

• {{navy|UK}} → 英國皇家海軍
• {{navy|Nazi Germany}} → 納粹德國
• {{navy|USSR}} → 蘇聯

Template:Army

例子如下：

• {{army|UK}} → 英國陸軍
• {{army|US}} → 美國

Template:Air force

例子如下：

• {{Air force|UK}} → 英國皇家空軍
• {{Air force|Nazi Germany}} → 納粹德國
• {{Air force|US}} → 美國

國家運動隊旗幟模板

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

• Template:bb → 棒球
• Template:bat → 羽毛球
• Template:bk → 籃球
• Template:cr → 木球（被其它模板使用）
• Template:fb → 足球
• Template:fh → 曲棍球
• Template:Futsal → 五人制足球
• Template:hb → 手球

• Template:ih → 冰球
• Template:korf → 合球 （暫無女子）
• Template:ru → 欖球
• Template:ru7 → 七人欖球
• Template:sb → 壘球
• Template:vb → 排球
• Template:wp → 水球

這些模板使用簡稱的原因是它們很可能會在一場賽事裡多次出現。這些模板亦完全取代了以前曾使用的國家隊模板。例如{{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運作原理

每次使用旗幟模板都會經過三個步驟。以上述的例子－{{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>

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

參見

• 模板連結：{{flagIOC}}=模板連結：{{AY}}用途相似，但專用於奧運會代表團。如： 澳洲
• 模板連結：{{Shipboxflag}}，用於船用旗幟。