Module:Countries/Caribbean/sandbox

Lua

Code Discussion Edit History Links Link count Subpages:Documentation Tests Results Sandbox Live code All modules

This documentation is transcluded from Module:Countries/Africa/doc.

The countries and text displayed for a particular region are defined in a subpage of Module:Countries. For example, Module:Countries/Africa lists the countries in Africa and defines text such as "Countries of Africa" that is displayed if the user's language is en, and "Staaten in Afrika" if it is de. Country names are obtained from Wikidata.

How to create data modules

Translated section titles

Each section under titles defines text that depends on the current user's language. The procedures that apply to {{Fallback}} are used to determine which language should be used.

TODO: Standard titles should be defined in one module so they do not need to be duplicated for each countries submodule. Only items listed in each section are translated once from Wikidata labels. This may require adding also Wikidata entries for them (or locating existing Wikidata items for their topic), and being able to select their plural form when needed.

Pattern or ordered list of subpatterns

Module:Countries/Africa defines pattern twice. The first is a pattern for the text that is normally displayed by {{Countries of Africa}}, while the second applies when the parameter |simple=yes is used.

Each occurrence of {name} in the pattern is replaced with appropriate text. The names used for Africa when simple does not apply are:

Name	Description
`{lang}`	User's language from `{{Int:Lang}}` such as "en" or "de".
`{dir}`	Direction "ltr" or "rtl" selected using lang.
`{colon}`	Equivalent of ": " from `{{Colon\|lang={{Int:Lang}}}}`; do not insert any space after it.
`{maintitle}`	Title from `titles.main` selected using lang.
`{othertitle}`	Title from `titles.other` selected using lang.
`{mainlist}`	List of country codes from `lists.main` selected using lang.
`{otherlist}`	List of country codes from `lists.other` selected using lang.
`{partlylist}`	List of country codes from `lists.partly` used to render a note only (this list is not sorted by languages as it is not displayed, but it provides the condition for which the note will be added, i.e. when one of the other lists includes a country which is displayed with an extra mark calling for this note).

You can specify patterns in various ways, the simplest one being a single string containing all the layout wikitext and {name} placeholders described above. This will only generate a static list with a single layout.

But you can also split the pattern into multiple "conditional supatterns" (all of them containing arbitrary wikitext or {name} placeholders), and put them in an ordered table, in the order in which they must appear on the result. This allows some fragments of the layout to be removed (for example dropping the section title if the list after it in the same section is empty, or dropping the static separators between sections).

Each "conditional subpattern" is represented either:

as a simple string like 'subpattern with {name} placeholders' when there's no condition (this unconditional pattern will be always added to the result), or
as an ordered table, where:
- first element is a string for the subpattern, and
- the other elements represent an union of several (non-exclusive) "conditions"
for example, { 'subpattern with {name} placeholders', condition1, condition2, ... }

(if any one of the listed conditions evaluates to true (OR), the conditional subpattern will be used).

Each "condition" listed in a array after the initial subpattern may itself be represented either:

as a simple string for "simple conditions", or
as an ordered table of "subconditions", i.e. a conjunction of several (non-exclusive) simple conditions
for example, { 'subpattern with {name} placeholders', { subcondition1, subcondition2, ... }, ... }

(if any one of the subconditions evaluates to false (AND), the conditional subpattern will NOT be used according to this condition, but may be used if other conditions part of the union allow it).

Each "simple condition" is used to evaluate tests based on names of variables (usable in placeholders of patterns or subpatterns). A simple condition is represented by a string and can currently take one the following forms:

'name' : the simple condition is true if the variable with that name is non-empty (i.e. the subpattern {name} would be replaced by an actual text);
'!name' : the simple condition is true if the variable with that name is empty (i.e. the subpattern {name} would be replaced by nothing);

The variable names used in simple conditions don't need to be present within the "conditional subpattern" string to which the condition applies (indicated at start of the table describing the conditional subpattern). This means for example that a subpattern continaining only static wikitext and no {name} placeholder, can be conditional. This is useful notably

to generate static wikitext (for example breaks or punctuation or other presentational elements), that will be present in the result only if other conditional patterns actually generate text (depending on their own placeholders).
to suppress every layout elements surrounding the inner content, when there's nothing useful to display: the result can then be entirely empty.

Simple presentation in a single section

If the template that invokes the module has |simple=yes, the simple section is used.

simple.pattern replaces pattern
simple.sections specifies which sections from titles and lists will be processed.

In Module:Countries/Africa, simple.sections has

main = { EH = true, },

The fact that main is defined means that titles.main and lists.main will be used. The fact that other is not defined means that titles.other and lists.other will be ignored.

EH = true is used when simple does not apply. When the template is used normally (without |simple=yes), the country identified by EH is ignored. That is done because EH is included in the other section. However, with |simple=yes, EH will appear in the main section.

The simple version can also use a single pattern, or multiple conditional subpatterns like previously.

Orderable lists of items, one for each section

Each section under lists defines the list of country codes that will be used to display country names. Similarly to titles, the list depends on the current user's language.

Countries are listed in the order specified. If the default order is unsatisfactory for a particular language, an entry for the language can be added. The entry should include all the country codes in a suitable order.

For example, lists.main may include the following (... replaces some text omitted for simplicity).

main = {
    english   = 'automatic',
    default   = 'automatic sorted',
    en        = 'automatic sorted',
    mk        = 'DZ AO BJ BW BF BI CM CAVE CF TD KM CI ... SADR EH ZM ZW',
    automatic = 'DZ AO BJ BW BF BI CM CAVE CF TD KM CD ...   UG EH ZM ZW',
},

Each country code such as DZ is defined under countries. All lists should contain the same codes, only ordered differently depending on language; every localized list (keyed by language code) should then have exactly the same length as the one given for the 'automatic' list (which is required), or should be one of 'automatic sorted' or 'automatic'.

The following keys have special meaning when used before =.

`automatic`	Must be defined if any other parameter is set to `'automatic'` or `'automatic sorted'`. The listed codes should be ordered according to the English names, so that they don't need sorting (see below).
`default`	The fallback entry used if the user's language is not defined ({{Fallback}} falls back to `en` if it is defined and no more applicable entry is defined).
`english`	The entry used if the user's language is `en`. This is an optimization to avoid the overhead of automatic processing for a commonly used language.

The following values have special meaning when used after =.

`'automatic'`	This entry will use the list of country codes defined in the `automatic = '...'` parameter.
`'automatic sorted'`	Same as `'automatic'` but (unless option `all` is set) the country names will be reordered using a crude sorting algorithm.

A module is not able to properly collate names for a language other than en. However, Module:Countries can satisfactorily collates some names that use letters with diacritics which sort after their equivalent letters.

The collation (performed only when the option all is not set when calling the main function Module:Countries) is based on a function, defined in Module:MakeSortKey, creating sort keys from a translated label and the target language code (this language code could be later used to tailor the collation according to sorting rules for specific languages, but for now the sort order is locale-neutral). Generally, this sorting works for most languages, but the localisation may be needed to take into account ignorable prefixes, or for complex scripts that still have no support for a basic collation order.

Definitions of each list item

Several examples from a countries table follow:

countries = {
    CI    = { 'Ivory Coast', "Côte d'Ivoire",  qid = 'Q1008', },
    DZ    = { 'Algeria',                       qid = 'Q262', },
    EG    = { 'Egypt',                         qid = 'Q79', mark = '‡', },
    GM    = { 'Gambia',                        qid = 'Q1005', the = true, },
    XBRTW = { 'Bir Tawil',                     qid = 'Q620634', },
}

CI, DZ, EG, and GM are country codes that identify a particular country. Where available, ISO 3166-2 codes are used, but any code can be used as they only have a meaning within the module (you should use a private extension, starting by "X", of ISO 3166-1 if the territory is part of another recognized country but has no ISO 3166-2 code, or use one of the prefixes reserved in ISO 3166-1 for private use, like "AA", "QM" to "QZ", "X", or "ZZ").

Note that Module:Countries is generic and is not restricted for listing only countries, it can process any list of up to 200 known items; the key defined as countries = {...} above can be alternatively named infos = {...} with the same content for list items.

The country names Algeria and Gambia are the titles of pages which should exist at Commons, and where the category page generally also exists. English names should be used but need to match names used in titles of titles in Commons. If several alternative names are used in Commons to refer to the same country in related page titles (such as "Côte d'Ivoire"), you may list these alternate names.

The qid codes identify the corresponding item at Wikidata. It allows translating the displayed label in the user's language (when option all is not set to render the box). For example,

d:Q262 on Wikidata is associated to Algeria on Commons, and will also be used to get the translated label for other related pages like Category:Algeria
d:Q1005 on Wikidata is associated to Gambia on Commons, and will also be used to get the translated label for other related pages like Category:Gambia

If the |all=yes option is not set to render the box, or if qid is not defined, or if qid is not found in Wikidata, or Wikidata does not define a label for it, then the first name listed in the data defining the country (normally in English and used in page titles in Commons) will be used as a default (untranslated) label.

Normally, a link is shown in the rendered bulleted lists only if the page exists.

But when rendering the list with |all=yes option, all possible page titles will be listed, without testing their existence, and without translating the displayed labels (this will frequently generate red links, but it allows the maintenance of page names on Commons, to find those that redirect to unexpected pages, or to facilitate the creation of missing pages with coherent titles that will be found and used when the |all=yes option will be removed to hide all possible aliases from the list and to get translated and sorted labels).

The entry for Gambia illustrates use of the optional the in country's data, whose effect is that the Gambia is tested for existence before Gambia: if a page exists in Commons using the in its title, this page will be selected as the target of the link.

The wikitext for each link has the following form:

[[PrefixTitleSuffix|<bdi>Label</bdi>]]

Prefix	Consists of the specified prefix and separator (or space).
Title	The name specified in the `countries` table, possibly prefixed by `the` (only if the data defining a country code includes `the = true`).
Suffix	Consists of the specified separator (or space) and suffix.
bdi	bidirectional isolation in HTML
Label	The label from Wikidata for the specified `qid` in the current user's language.

The entry for Egypt illustrates use of the optional mark in country's data, whose effect is that a superscripted mark will be added after the label. This is used as a note call, which will be rendered at bottom of the table. If you use such marks, you should create a conditional section (such as "partly") which lists all concerned codes (in arbitrary code order); this list will not be rendered, but will appear conditionally if any one of the listed codes is displayed from the other lists.

Related modules and templates

This list (currently maintained in Module:Convert/tester) is partial but contains the most frequently used modules. It autodetects differences between the normal modules and templates and their sandbox version, and list their associated testcases and talk pages (when they exist).

It also shows that the main module is not necessarily used for listing countries (or territories), it could be used as well to create navigation boxes for lists of cities, chemical elements, and so on, provided that these lists are bounded, wellknown and stable over years (and not overlong) : if a list contains more than 200 items, consider generated separate modules and navbox for sublists using some criteria). New data modules also don't necessarily have to be created and named as subpages of Module:Countries.

The sandbox versions of modules should be identical, except temporarily for testing changes (rendered with the sandbox template, in their comparative test cases)

Modules in Commons Module:Countries · sandbox · testcases · talk Module:Countries/Africa · sandbox · testcases · talk Module:Countries/Americas · sandbox · testcases · talk Module:Countries/Arab world · sandbox · testcases · talk Module:Countries/Asia · sandbox · testcases · talk Module:Countries/Caribbean · sandbox · testcases · talk Module:Countries/Central America · sandbox · testcases · talk Module:Countries/Europe · sandbox · testcases · talk Module:Countries/European Union · sandbox · testcases · talk Module:Countries/North America · sandbox · testcases · talk Module:Countries/North America (subcontinent) · sandbox · testcases · talk Module:Countries/Oceania · sandbox (different content) · testcases · talk Module:Countries/South America · sandbox · testcases · talk Module:Countries/CRT other · sandbox · testcases · talk Module:Countries/Olympic teams · sandbox · testcases · talk Module:Countries/United Kingdom · sandbox (different content) · testcases · talk Module:Regions of France · sandbox · testcases · talk Module:Departments of France · sandbox (different content) · testcases · talk Module:States of the United States · sandbox · testcases · talk Module:Most populous cities of the world · sandbox · testcases · talk	Templates in Commons using these modules The sandbox versions of these templates should be different as they use the sandbox version of the modules. {{Countries of Africa}} · sandbox (different content) · testcases · talk {{Countries of the Americas}} · sandbox (different content) · testcases · talk {{Countries of the Arab world}} · sandbox (different content) · testcases · talk {{Countries of Asia}} · sandbox (different content) · testcases · talk {{Countries of the Caribbean}} · sandbox (different content) · testcases · talk {{Countries of Central America}} · sandbox (different content) · testcases · talk {{Countries of Europe}} · sandbox (different content) · testcases · talk {{Countries of the European Union}} · sandbox (different content) · testcases · talk {{Countries of North America}} · sandbox (different content) · testcases · talk {{Countries of North America (subcontinent)}} · sandbox (different content) · testcases · talk {{Countries of Oceania}} · sandbox (different content) · testcases · talk {{Countries of South America}} · sandbox (different content) · testcases · talk {{Copyright rules by territory}} · sandbox (different content) · testcases · talk {{Olympic teams}} · sandbox (different content) · testcases · talk {{Countries of the United Kingdom}} · sandbox (different content) · testcases · talk {{Regions of France}} · sandbox (different content) · testcases · talk {{Departments of France}} · sandbox (different content) · testcases · talk {{States of the United States}} · sandbox (different content) · testcases · talk {{Most populous cities of the world}} · sandbox (different content) · testcases · talk

How to make changes and preview them using sandboxes

For example, {{Countries of Africa/sandbox}} displays:

If the user's language is en, Module:Countries/Africa/sandbox could be edited and

en = 'Countries of Africa',

changed to

en = 'African countries',

Do not save the change. Instead, under "Preview page with this template" enter the title of this page

Module:Countries/Africa/doc

then click "Show preview". That will display this documentation page including the output from the above {{Countries of Africa/sandbox}} template. The output will start with "African countries" instead of "Countries of Africa". In the same manner, other changes could be made and previewed before saving the changes. Close the current browser window without saving the changes to discard them (or get back to a previous page using the button of the browser navigating in the session history).

Before updating the main data module, changes should be made in the sandbox data module and tested with the sandbox template.

Code

--[=[
Data defining countries for {{#invoke:Countries|main|Caribbean}}.

Output is pattern after making these substitutes:
{lang}		User's language from {{int:lang}} such as 'en' or 'de'.
{dir}		Language direction 'ltr' or 'rtl'.
{colon}		Language equivalent of ": " from {{colon|lang}}.
{XYZtitle}	Title for lang from XYZ section of defined titles.
{XYZlist}	List of countries for lang from XYZ section of defined lists.
			XYZ must consist of alphanumeric characters, preferably in [A-Za-z].
]=]
return {
	titles = {
		main = {
			default = 'Insular countries of the Caribbean',
			['be-tarask'] = 'Астраўныя краіны Карыбаў',
			ca = 'Països insulars del Carib',
			de = 'Inselländer der Karibik',
			en = 'Insular countries of the Caribbean',
			es = 'Países insulares del Caribe',
			fr = 'Pays insulaires de la Caraïbe',
			mk = 'Островски земји на Карибите',
			nb = 'Øystater i Karibia',
			nn = 'Øystatar i Karibia',
			no = 'Øystater i Karibia',
			pt = 'Países insulares do Caribe',
			ru = 'Островные страны Карибского моря',
			sl = 'Otoške države Karibov',
			sr = 'Острвске земље Кариба',
			['sr-latn'] = 'Ostrvske zemlje Kariba',
			['zh-hans'] = '加勒比岛国',
			['zh-hant'] = '加勒比島國',
		},
		continental = {
			default = 'Continental countries',
			['be-tarask'] = 'Кантынэнтальныя краіны',
			ca = 'Països continentals',
			de = 'Kontinentale Länder',
			en = 'Continental countries',
			es = 'Países continentales',
			fr = 'Pays continentaux',
			mk = 'Континентални земји',
			nb = 'Kontinentale land',
			nn = 'Kontinentale land',
			no = 'Kontinentale land',
			pt = 'Países continentais',
			ru = 'Прибрежные страны',
			sl = 'Celinske države',
			sr = 'Континенталне земље',
			['sr-latn'] = 'Kontinentalne zemlje',
			['zh-hans'] = '内陆国家',
			['zh-hant'] = '內陸國家',
		},
		other = {
			default = 'Other territories',
			af = 'Ander gebiede',
			am = 'ሌሎች ግዛቶች',
			ar = 'مناطق أخرى',
			az = 'Digər ərazilər',
			be = 'Іншыя тэрыторыі',
			['be-tarask'] = 'Іншыя тэрыторыі',
			bg = 'Други територии',
			bn = 'অন্যান্য অঞ্চল',
			bs = 'Druga područja',
			ca = 'Altres territoris',
			ceb = 'Ang ubang mga teritoryo',
			co = 'Àutri tirritori',
			cs = 'Jiných území',
			cy = 'Thiriogaethau eraill',
			da = 'Andre områder',
			de = 'Weitere Gebiete',
			el = 'Άλλα εδάφη',
			en = 'Other territories',
			eo = 'Aliaj teritorioj',
			es = 'Otros territorios',
			et = 'Muud territooriumide',
			eu = 'Beste lurralde',
			fa = 'سرزمین های دیگر',
			fi = 'Muut alueet',
			fr = 'Autres territoires',
			fy = 'Oare gebieten',
			ga = 'Críocha eile',
			gd = 'Tìrean eile',
			gl = 'Outros territorios',
			gu = 'અન્ય પ્રદેશો',
			ha = 'Sauran yankuna',
			haw = 'Nā panalāʻau e noho',
			he = 'טריטוריות אחרות',
			hi = 'अन्य प्रदेश',
			hmn = 'Lwm yam cheeb tsam',
			hr = 'Ostala područja',
			ht = 'Lòt teritwa',
			hu = 'Más területeken',
			hy = 'այլ տարածքներ',
			id = 'Wilayah lainnya',
			ig = 'Ọzọ n’ókèala',
			is = 'Önnur svæði',
			it = 'Altri territori',
			ja = 'その他の地域',
			jv = 'Wilayah liyane',
			ka = 'სხვა ტერიტორიები',
			kk = 'Ѳзге де аумақтары',
			km = 'ទឹកដីផ្សេងទៀត',
			kn = 'ಇತರ ಪ್ರದೇಶಗಳು',
			ko = '기타 지역',
			ku = 'Deverên din',
			ky = 'Башка аймактар',
			la = 'Alios fines',
			lb = 'Aneren Territoiren',
			lo = 'ອານາເຂດອື່ນໆ',
			lt = 'Kitos teritorijos',
			lv = 'Citas teritorijas',
			mg = 'Faritra hafa',
			mi = 'Atu rohe',
			mk = 'Други подрачја',
			ml = 'മറ്റ് ഭൂപ്രദേശങ്ങൾ',
			mn = 'Бусад нутаг дэвсгэрүүд',
			mr = 'इतर प्रदेश',
			ms = 'Wilayah lain',
			mt = 'Territorji oħrajn',
			my = 'သည်အခြားနယ်မြေများတွင်',
			ne = 'अन्य क्षेत्रहरूमा',
			nb = 'Andre territorier',
			nl = 'Andere gebieden',
			nn = 'Andre territorium',
			no = 'Andre territorier',
			ny = 'M’madera ena',
			pa = 'ਹੋਰ ਇਲਾਕਿਆਂ',
			pl = 'Inne terytoria',
			ps = 'د نورو سیمو',
			pt = 'Outros territórios',
			ro = 'Alte teritorii',
			ru = 'Другие территории',
			sd = 'ٻين جي حدن ۾',
			si = 'අනෙකුත් බලප්රදේශ',
			sk = 'Na iných územiach',
			sl = 'Druga ozemlja',
			sm = 'Isi oganuu',
			sn = 'Dzimwe ndima',
			so = 'Dhulal kale',
			sq = 'Territore të tjera',
			sr = 'Друге територије',
			['sr-latn'] = 'Druge teritorije',
			st = 'Masimong a mang',
			su = 'Wewengkon séjén',
			sv = 'Andra territorier',
			sw = 'Maeneo mengine',
			ta = 'மற்ற பிரதேசங்கள்',
			te = 'ఇతర భూభాగాలు',
			tg = 'Ҳудудҳои дигар',
			th = 'ดินแดนอื่น ๆ',
			tl = 'Iba pang mga teritoryo',
			tr = 'Diğer bölgeler',
			uk = 'Інші території',
			ur = 'دوسرے علاقے',
			uz = 'Boshqa hududlar',
			vi = 'Lãnh thổ khác',
			xh = 'Neminye imimandla',
			yi = 'אנדערע טעראַטאָריז',
			yo = 'miiran ilẹ',
			['zh-hans'] = '其他地区',
			['zh-hant'] = '其他地區',
			zu = 'Ezinye izigceme',
		},
	},
	pattern =
		'<div lang="{lang}" dir="{dir}" class="catlinks" ' ..
		'style="clear:none;margin:2px 0;padding:2px;font-size:88%;line-height:normal">' ..
		'<em>{maintitle}{colon}</em>{mainlist}<br /> ' ..
		'<em>{continentaltitle}{colon}</em>{continentallist}<br /> ' ..
		'<em>{othertitle}{colon}</em>{otherlist}' ..
		'</div>',
	simple = {
		pattern =
			'<div lang="{lang}" dir="{dir}" class="catlinks" ' ..
			'style="clear:none;margin:2px 0;padding:2px;font-size:88%;line-height:normal">' ..
			'<em>{maintitle}{colon}</em>{mainlist}' ..
			'</div>',
		sections = {
			-- List of sections to be displayed if simple=yes.
			-- Each value is a table identifying any country code that is added to that section only if simple=yes.
			main = {
				AI = true,
				AW = true,
				BL = true,
				CW = true,
				GF = true,
				GP = true,
				KY = true,
				MF = true,
				MQ = true,
				MS = true,
				NLCAR = true,
				PR = true,
				SX = true,
				TC = true,
				UMNAV = true,
				USFLK = true,
				VG = true,
				VI = true,
			},
		},
	},
	lists = {
		-- List of countries in an order suitable for display in the specified language.
		main = {
			default     = 'automatic sorted',  -- currently unused because en is defined below
			en          = 'automatic sorted',  -- this applies with uselang=XX where XX is not defined below
			english     = 'automatic',         -- this applies with uselang=en (don't sort, use the automatic list directly)
			automatic   = 'AG BS BB CU DM DO GD HT JM KN LC VC TT',
			nb          = 'automatic',
			nn          = 'automatic',
			no          = 'automatic',
			['zh-hans'] = 'AG BB BS DO DM GD CU HT KN LC VC TT JM',
			['zh-hant'] = 'AG BB BS DM DO GD CU HT TT KN LC VC JM',
			['zh-hk']   = 'AG BB BS DO DM GD CU HT TT KN LC VC JM', -- use 'zh-hans'?
		},
		continental = {
			default     = 'automatic sorted',  -- currently unused because en is defined below
			en          = 'automatic sorted',  -- this applies with uselang=XX where XX is not defined below
			english     = 'automatic',  -- this applies with uselang=en (don't sort, use the automatic list directly)
			automatic   = 'BZ CO CR GT GY HN MX NI PA SR VE',
			['zh-hans'] = 'PA BZ CO CR GY HN MX NI SR GT VE',
			['zh-hant'] = 'PA BZ CO CR GT GY HN MX NI SR VE',
			['zh-hk']   = 'PA BZ CO CR GY HN MX NI SR GT VE', -- use 'zh-hans'?
		},
		other = {
			default     = 'automatic sorted', -- currently unused because en is defined below
			en          = 'automatic sorted', -- this applies with uselang=XX where XX is not defined below
			english     = 'automatic',        -- this applies with uselang=en (don't sort, use the automatic list directly)
			automatic   = 'AI AW VG KY CW USFLK GF GP MQ NLCAR MS UMNAV PR BL MF SX TC VI',
			nb          = 'VI AI AW VG KY CW USFLK GF GP NLCAR MQ MS UMNAV PR BL MF SX TC',
			nn          = 'VI AI AW VG KY CW USFLK GF GP NLCAR MQ MS UMNAV PR BL MF SX TC',
			no          = 'VI AI AW VG KY CW USFLK GF GP NLCAR MQ MS UMNAV PR BL MF SX TC',
			['zh-hans'] = 'AW AI PR GF MF USFLK GP NLCAR SX KY CW MQ VI MS UMNAV BL TC VG',
			['zh-hant'] = 'AW AI PR GF MF USFLK GP CW NLCAR SX KY MQ VI MS UMNAV BL TC VG',
			['zh-hk']   = 'AW AI PR GF MF USFLK GP NLCAR SX KY CW MQ VI MS UMNAV BL TC VG', -- use 'zh-hans'?
		},
	},
	countries = {
		-- Keys are arbitraly set as capital codes from ISO3166-1, possibly extended with ISO3166-2, or longer for specific areas.
		-- They must match codes used in the above lists, but have otherwise no other implied meaning outside this module.
		-- The given name given must match a target category name in English to match in Commons (possibly prefixed by "the" where indicated).
		-- The qid must match the topic in Commons, used to translate the displayed labels.
		-- The list below is sorted by the given labels, allowing to create easily the default "automatic" order used directly for English.
		AG    = { "Antigua and Barbuda",              qid = 'Q781', },
		AI    = { "Anguilla",                         qid = 'Q25228', },
		AW    = { "Aruba",                            qid = 'Q21203', },
		BB    = { "Barbados",                         qid = 'Q244', },
		BL    = { "Saint-Barthélemy",                 qid = 'Q25362', },
		BS    = { "Bahamas",                          qid = 'Q778', the = true, },
		BZ    = { "Belize",                           qid = 'Q242', },
		CO    = { "Colombia",                         qid = 'Q739', },
		CR    = { "Costa Rica",                       qid = 'Q800', },
		CU    = { "Cuba",                             qid = 'Q241', },
		CW    = { "Curaçao",                          qid = 'Q25279', },
		DM    = { "Dominica",                         qid = 'Q784', },
		DO    = { "Dominican Republic",               qid = 'Q786', the = true, },
		GD    = { "Grenada",                          qid = 'Q769', },
		GF    = { "French Guiana",                    qid = 'Q3769', },
		GP    = { "Guadeloupe",                       qid = 'Q17012', },
		GT    = { "Guatemala",                        qid = 'Q774', },
		GY    = { "Guyana",                           qid = 'Q734', },
		HN    = { "Honduras",                         qid = 'Q783', },
		HT    = { "Haiti",                            qid = 'Q790', },
		JM    = { "Jamaica",                          qid = 'Q766', },
		KN    = { "Saint Kitts and Nevis",            qid = 'Q763', },
		KY    = { "Cayman Islands",                   qid = 'Q5785', the = true, },
		LC    = { "Saint Lucia",                      qid = 'Q760', },
		MF    = { "Saint-Martin (France)",
		          "Saint Martin (France)",            qid = 'Q126125', },
		MQ    = { "Martinique",                       qid = 'Q17054', },
		MS    = { "Montserrat",                       qid = 'Q13353', },
		MX    = { "Mexico",                           qid = 'Q96', },
		NI    = { "Nicaragua",                        qid = 'Q811', },
		NLCAR = { "Caribbean Netherlands",            qid = 'Q27561', the = true, },
		PA    = { "Panama",                           qid = 'Q804', },
		PR    = { "Puerto Rico",                      qid = 'Q1183', },
		SR    = { "Suriname",                         qid = 'Q730', },
		SX    = { "Sint Maarten",
		          "Sint Maarten, Dutch Caribbean",    qid = 'Q26273', },
		TC    = { "Turks and Caicos Islands",         qid = 'Q18221', the = true, },
		TT    = { "Trinidad and Tobago",              qid = 'Q754', },
		UM    = { "United States Minor Outlying Islands",
		                                              qid = 'Q16645', the = true, },
		UMNAV = { "Navassa Island",                   qid = 'Q25359', },
		USFLK = { "Florida Keys",                     qid = 'Q537749', the = true, },
		VC    = { "Saint Vincent and the Grenadines", qid = 'Q757', },
		VE    = { "Venezuela",                        qid = 'Q717', },
		VG    = { "British Virgin Islands",           qid = 'Q25305', the = true, },
		VI    = { "United States Virgin Islands",     qid = 'Q11703', the = true, },
	},
}