Template:Foo–Bar relations category/doc

Creates a category page for a category of bilateral relations between two countries named "Foo" and "Bar".

The page name must take the form "Category:Foo–Bar relations", with an endash between the two country names. If the title does not take this form, the template will report an error.

Note that use on "Category:Foo-Bar relations" will be treated as an error, because it uses a dash rather than an endash.

Usage
Two optional parameters are available:
 * , which sets the name of the "main article" linked in the category header. The default is the category title, but in some cases this may not be appropriate:
 * , which sets the filename of the map displayed in the category header. The default is derived from the category title, but in some cases this may be in appropriate or unavailable

"The" Country
This template uses CountryPrefixThe to intelligently handle countries whose name is prefixed by "the" in running text. e.g. "the United States" or "the Soviet Union"

Example: Category:Comoros–Ghana relations

Exceptions
In some cases, the parent  may use a different name to that used in "Category:SomeCountry–OtherCountry relations" categories. In such cases, a sub-template Template:Foo–Bar relations category/fixcountryname handles the correction. As of December 2018, its only entry is Palestine/State of Palestine: e.g. Category:Ireland–State of Palestine relations is a subcat of Category:Bilateral relations of the State of Palestine.

Location map
Unless a map parameter is supplied, the sub-template Foo–Bar relations category/mapname looks for a map, and displays it if found.

There is a large collection of bilateral maps at Commons:Category:Bilateral maps.

For an example Category:Foo–Bar relations, the template looks in the following order:
 * 1) File:Foo Bar Locator.png
 * 2) File:Foo Bar Locator.svg
 * 3) File:Bar Foo Locator.png
 * 4) File:Bar Foo Locator.svg

If no file is found with those titles, the search is repeated using a lower "locator".

Tracking categories

 * Used on a non-category page
 * Category:Template Foo–Bar relations on non-category page (population: )
 * Used on category page with an invalid title
 * Category:Template Foo–Bar relations category on page with invalid title (population: )
 * "main=" has a non-nil value
 * Category:Template Foo–Bar relations category with specified main article (population: )
 * "main=" has a non-nil value, but the page specified does not exist
 * Category:Template Foo–Bar relations category with non-existent specified main article (population: )
 * A location map is generated
 * Category:Template Foo–Bar relations category with a locator map (population: )
 * No location map is generated
 * Category:Template Foo–Bar relations category with no locator map (population: )
 * "map=" has a non-nil value
 * Category:Template Foo–Bar relations category with specified map (population: )
 * "map=" has a non-nil value, but the page specified does not exist
 * Category:Template Foo–Bar relations category with non-existent specified map (population: )