Template:Map caption/doc

{{

| type = notice | image = none | imageright = | style = | textstyle = | text = This is a documentation subpage for Template:Map caption (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page. | small = | smallimage = | smallimageright = | smalltext = }}

Template intended to simplify adding a standardized and formatted caption below a map indicating the location of something (e.g. a country), possibly referring to the map's main region and optionally also to a shown subregion. Original use within infoboxes (e.g. see articles on European countries). For a complete set of elements (see Parameters) of reasonable length, a width of typically (minimally) 250px (without extra padding or margins) should be available.

Parameters

Parameter			Default
(optional)	countryprefix	Neither linked nor styled prefix e.g. "the" (for articles named e.g. "United Kingdom", "Czech Republic", "Netherlands")	–
(optional)	country	Only if the country name at the map should not be identical to the article name (e.g. "Metropolitan France") Template sets [[...]], thus if identical to article name (default) in article shown in bold instead of linked	<article name>
(optional)	location	Only if hereunder colour is not used and its default not appropriate: Description identifying country's location (e.g. "circled in inset") This parameter must never be empty; "none" suppresses it. If passed, location_color cannot be shown	–
(optional)	location_color	Only if above description is not used: Colour identifying country's location; "none" suppresses showing the default.	orange
(optional)	region	Name (or equally extremely short description) for approximately the entire area depicted by the map. special: "[[Europe]]" shown as "on the European continent", special: "[[Antarctica]]" shown as "on Antarctica", special: "[[Middle East]]", "[[Arctic Circle]]" or "[[Pacific Ocean]]" shown as "in the ...", special: versus any other: shown as "in ...", e.g. "[[Africa]]" shown as "in Africa"	–
(optional)	region_color	Colour identifying region; "none" suppresses showing the default.	white
(optional)	subregion	Subregion indicated within region (only if used: aligning both region and subregion lines to the left, else single region line centered as top line) Must not occur without parameter region. special: "[[EU]]" or "[[European Union]]" shown as "in the European Union", special: versus any other: shown as "in ...", e.g. "the [[Caucasus]]" shown as "in the Caucasus"	–
(optional)	subregion_color	Colour identifying subregion; "none" suppresses showing the default.	camel
(optional)	legend	Filename of image providing a map legend	–
Note: In case the name of any article or redirect page on this Wikipedia is given for a country, region or subregion (without other characters in the parameter), the template automatically creates a link. It is nevertheless possible to pass a parameter between linking brackets [[...]] and such is required in case only a part of the parameter should be linked or in case a link should reach an article by another name using syntax [[...|...]].

Examples

Code	Raw result (in unformatted box, compare to handling in Infobox)
{{map caption}}
	Location of  Map caption/doc  (orange)
{{map caption |region=[[Europe]] |legend=European location legend en.png}}
	Location of  Map caption/doc  (orange) on the European continent  (white)  —  [Legend]
{{map caption |countryprefix=the |region=[[Europe]] |subregion=the [[European Union]] |legend=European location legend en.png}}
	Location of the  Map caption/doc  (orange) – on the European continent  (camel & white) – in the European Union  (camel)                 [Legend]
Typical sample for an article on a European Union member that needs no "the" before its name, for otherwise identical output: {{map caption |region=Europe |subregion=EU |legend=European location legend en.png}}
	Location of  Map caption/doc  (orange) – on the European continent  (camel & white) – in the European Union  (camel)                 [Legend]

Infobox usage of code (as intended) — wherein the alignment, the padding/margins, and font are rendered differently (this template adjusts for that infobox):

Sample for article named 'Armenia', about a non-European country {{Infobox Country or territory| |common_name = Armenia |image_map = Europe location ARM.png |map_caption = {{map caption}} |(other for the Infobox required parameters omitted from sample) }} Sample for article named 'Belarus', about a non-member of the EU {{Infobox Country or territory| |common_name = Belarus |image_map = Europe location BLR.png |map_caption = {{map caption |region=[[Europe]] |legend=European location legend en.png}} |(other for the Infobox required parameters omitted from sample) }} Sample for article named 'Netherlands', about a member of the EU {{Infobox Country or territory| |common_name = the Netherlands |image_map = EU location NED.png |map_caption = {{map caption |countryprefix=the |region=[[Europe]] |subregion=the [[European Union]] |legend=European location legend en.png}} |(other for the Infobox required parameters omitted from sample) }}

Net result — The three simplified samples above, shown here side by side Net result — (called here not from countries' page and without country parameter): Location of  Map caption/doc  (orange) Capital x Official languages x Government x Area  -  Total 0 km2 0 sq mi   -  Density 0/km2 (0) 0/sq mi Currency x (x) Time zone x (UTC0) Calling code 0 Internet TLD x Location of  Map caption/doc  (orange) on the European continent  (white)  —  [Legend] Capital x Official languages x Government x Area  -  Total 0 km2 0 sq mi   -  Density 0/km2 (0) 0/sq mi Currency x (x) Time zone x (UTC0) Calling code 0 Internet TLD x Location of the  Map caption/doc  (orange) – on the European continent  (camel & white) – in the European Union  (camel)                 [Legend] Capital x Official languages x Government x Area  -  Total 0 km2 0 sq mi   -  Density 0/km2 (0) 0/sq mi Currency x (x) Time zone x (UTC0) Calling code 0 Internet TLD x