Projet:Modèle/Système Country

Une page de Wikipédia, l'encyclopédie libre.

Le système country est un ensemble de modèles servant à afficher des drapeaux de pays, avec ou sans lien vers l'article correspondant. Pour un pays donné, plusieurs variantes du drapeau peuvent être disponibles, selon l'année ou le contexte. Ce système est une adaptation des modèles de Wikipédia en anglais, gérés par en:Wikipedia:WikiProject Flag Template.

Utilisation[modifier | modifier le code]

Lien vers un pays avec drapeau[modifier | modifier le code]

Pour la plupart des pays, il existe un modèle nommé d'après le pays qui affiche un drapeau et un lien vers le pays. Ces modèles sont répertoriés dans Catégorie:Modèle pays et drapeau. La sous-catégorie Catégorie:Modèle pays et drapeau historique contient les anciens drapeaux de pays qui ont changé de drapeau ou ont disparu.

Exemples :

Pour personnaliser la taille du drapeau ou le texte affiché, ou encore pour créer d'autres modèles, on peut utiliser directement {{Pays}} :

  • {{Pays|Allemagne|nom=Allemand|taille=30}}Drapeau de l'Allemagne Allemand

Le modèle {{Pays}} sert aussi à afficher des variantes d'un drapeau pour lesquels il n'existe pas de modèle spécifique, avec la syntaxe {{Pays|nom du pays|variante}} :

  • {{Pays|France|libre}}Drapeau de la France France
  • {{Pays|France|royal}}Drapeau de la France France

Drapeau seul[modifier | modifier le code]

Le modèle {{Drapeau}} affiche le drapeau d'un pays. Dans sa forme la plus simple, il prend comme seul paramètre le nom du pays :

  • {{Drapeau|France}}Drapeau de la France
  • {{Drapeau|États-Unis}}Drapeau des États-Unis

Comme le modèle {{Pays}}, on peut indiquer une variante et changer la taille :

  • {{Drapeau|France|libre}}Drapeau de la France
  • {{Drapeau|Allemagne|taille=30}}Drapeau de l'Allemagne

Variantes de drapeaux disponibles[modifier | modifier le code]

Pour connaitre les différentes variantes disponibles de drapeaux d'un pays, et savoir lesquelles utiliser selon l'époque ou bien le contexte, voir Aide:Modèle pays et drapeau. Il est possible que certaines variantes peu utilisées ne soient pas mentionnées sur cette page d'aide, il faut dans ce cas se reporter au modèle country data du pays.

Les différentes variantes des drapeaux sont définies dans des modèles country data, un pour chaque pays. Certaines subdivisions territoriales disposent aussi d'un modèle. Ces modèles sont nommés de la manière suivante : Modèle:Country data Nom du pays (exemple pour l'Afrique du Sud : Modèle:Country data Afrique du Sud).

Ces données peuvent êtres incomplètes pour certains pays. N'hésitez pas à les compléter le cas échéant. Voyez la section #Ajout de pays et modification pour cela.

Lien vers les forces armées[modifier | modifier le code]

Les modèles {{Armée de terre}}, {{Armée de l'air}} et {{Marine de guerre}} permettent de créer un lien vers les forces terrestres, aériennes et navales d'un pays.

Exemples :

Ces modèles sont équivalents respectivement aux modèles de la Wikipédia en anglais suivants : en:Template:Army (armée de terre) en:Template:Air force (armée de l'air) et en:Template:Navy (marine de guerre).

À noter que la Wikipédia en français ne dispose pas de modèles équivalents à en:Template:Coast guard (garde-côtes), en:Template:Marines (marines) ou en:Template:Armed forces (forces armées).

Certains pays ne disposent pas encore de ces données, car leur modèle country data est encore incomplet. N'hésitez pas à compléter les données manquantes dans ce cas.

Ajout de pays et modification[modifier | modifier le code]

Pour chaque pays, le système country a besoin d'un Modèle:Country data Nom du pays. Les modèles existants sont rassemblés dans Catégorie:Modèle Country data. La syntaxe des modèles de données est compatible avec celle de la Wikipédia en anglais. Ceux-ci peuvent donc être importés directement, à condition de traduire le nom du pays. Il est aussi possible de simplement compléter les modèles country déjà existants, par exemple en ajoutant d'anciens drapeaux manquants en se basant sur le modèle anglais concerné.

Syntaxe[modifier | modifier le code]

Syntaxe minimale d'un modèle Modèle:Country data Nouveau pays pour que {{Drapeau|Nouveau pays}} et {{Pays|Nouveau pays}} marchent (ne définit ni variante, ni clé de tri personnalisée) :

{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = Titre de l'article sur le pays
| flag alias = Image du drapeau
| size = {{{size|}}}
| name = {{{name|}}}
| variant = {{{variant|}}}
| altlink = {{{altlink|}}}
| altvar = {{{altvar|}}}
}}

Syntaxe complète :

{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = Titre de l'article sur le pays
| shortname alias = Nom du pays
| alt attribute = Texte alternatif pour le drapeau
| flag alias = Image du drapeau
| flag alias-variante1 = Image du drapeau de la variante 1
| flag alias-variante2 = Image du drapeau de la variante 2
| sortkey = Clé de tri
| size = {{{size|}}}
| name = {{{name|}}}
| variant = {{{variant|}}}
| altlink = {{{altlink|}}}
| altvar = {{{altvar|}}}
<noinclude>
| var1 = variante1
| var2 = variante2
| redir1 = redirection 1
| redir2 = redirection 2
| related1 = modèle contry data connexe 1
| related2 = modèle contry data connexe 2
| cat = suffixe de catégorie de modèles
</noinclude>
}}

Paramètres[modifier | modifier le code]

Paramètres de données standards[modifier | modifier le code]

alias
Nom de l'article sur le pays (obligatoire).
Exemple : Luxembourg (pays)
shortname alias
Nom du pays (facultatif).
Ce paramètre correspond au texte affiché du lien. Il peut être omis si identique au paramètre alias.
Exemple : Luxembourg
alt attribute
Attribut alt pour l'image du drapeau (recommandé)
Exemple : Drapeau du Luxembourg.
Par défaut : Drapeau : <alias>
flag alias
Nom de l'image du drapeau, sans lien et sans le préfixe « Fichier: » (obligatoire)
Pour la plupart des pays, l'image du drapeau est nommée Flag of nom du pays en anglais.svg.
Exemple : Flag of Luxembourg.svg
flag alias-variante
Même format que flag alias, sert à définir les drapeaux des différentes variantes.
Remplacer variante par le nom que vous voulez donner à la variante.
Par convention, le nom de la variante est une année pour les anciens drapeaux, et en minuscule en cas de texte (sauf pour les sigles).
Toute variante ajoutée avec ce paramètre (sauf les composantes militaires spéciales) doit être documenté avec varX.
Exemples :
Voir {{Country data Afrique du Sud}} pour différents exemples.
sortkey
Clé de tri personnalisée utilisée pour la catégorisation du modèle dans Catégorie:Modèle Country data. Est également utilisé comme clé de tri pour les tableaux pour trier des modèles {{Pays}} qui seraient insérés dans un tableau.
Voir la section #Catégorisation pour plus d'informations sur la catégorisation des modèles Country data.
Ce paramètre est optionnel. La clé de tri est définie par la valeur du premier des paramètres suivants qui sera présent dans le code, par ordre de priorité :
  1. Paramètre sortkey,
  2. Paramètre shortname alias,
  3. Paramètre alias.

Paramètres pour les forces armées[modifier | modifier le code]

Ces paramètres spéciaux sont utilisés par les modèles {{Marine de guerre}}, {{Armée de l'air}} et {{Armée de terre}}.

À noter qu'il n'y a pas besoin de documenter ces variantes, les drapeaux concernés sont automatiquement documentés.

Marine de guerre ({{Marine de guerre}})
flag alias-naval
Contiens l'image du pavillon de la marine de guerre (optionnel si pavillon identique au drapeau du pays).
link alias-naval
Contiens le nom de l'article consacré à la marine de guerre.
Armée de l'air ({{Armée de l'air}})
flag alias-air force
Contiens l'image du drapeau de l'armée de l'air (optionnel si drapeau identique à celui du pays).
link alias-air force
Contiens le nom de l'article consacré à l'armée de l'air.
Armée de terre ({{Armée de terre}})
flag alias-army
Contiens l'image du drapeau de l'armée de terre (optionnel si drapeau identique à celui du pays).
link alias-army
Contiens le nom de l'article consacré à l'armée de terre.

Il n'est pas possible actuellement d'utiliser des variantes de drapeaux et pavillons de composantes militaires avec les modèles {{Marine de guerre}}, {{Armée de l'air}} ou {{Armée de terre}}.

Mais il est néanmoins possible d'en définir avec le paramètre flag alias-variante et de les documenter avec varX = variante. Pour les utiliser, il faut passer par {{Drapeau}} et faire un lien interne à côté vers l'article approprié. Exemple : {{drapeau|Afrique du Sud|naval-1928}} [[Marine sud-africaine]].

Par convention, afin de garantir la compatibilité future, si l'utilisation de variantes devait être supportée à l'avenir par ces modèles, il faut impérativement nommer les variantes de composantes militaires en les faisant précéder du nom de la composante militaire, suivi d'un tiret. Exemple : naval-1928.

Il existe aussi trois autres composantes militaires en usage sur la Wikipédia en anglais, mais dont les données ne font actuellement pas l'objet d'une exploitation spécifique sur la Wikipédia en français (aucun modèle spécifique n'exploite ces paramètres à l'heure actuelle). Néanmoins les éventuels drapeaux saisis sont documentés automatiquement et peuvent êtres utilisés avec le modèle {{Drapeau}} (par exemple {{Drapeau|Afrique du Sud|military}} affichera Drapeau d'Afrique du Sud).

Les paramètres suivants peuvent donc êtres remplis (ou conservés lors d'une importation depuis la Wikipédia en anglais), au cas où ces données seraient utilisées un jour :

Infanterie de marine
flag alias-marines
Contiens l'image du drapeau de l'infanterie de marine (optionnel si drapeau identique à celui du pays).
link alias-marines
Contiens le nom de l'article consacré à l'infanterie de marine (aucune utilisation du contenu de ce paramètre actuellement).
Garde-côtes
flag alias-coast guard
Contiens l'image du pavillon des garde-côtes (optionnel si pavillon identique au drapeau du pays).
link alias-coast guard
Contiens le nom de l'article consacré à la garde-côtière (aucune utilisation du contenu de ce paramètre actuellement).
Forces armées
flag alias-military
Contiens l'image du drapeau des forces armées du pays (optionnel si drapeau identique à celui du pays).
link alias-military
Contiens le nom de l'article consacré aux forces armées du pays (aucune utilisation du contenu de ce paramètre actuellement).

Les modèles qui utilisent ces données sur la Wikipédia en anglais, et qui n'ont pas d'équivalent ici, sont : en:Template:Coast guard (garde-côtes), en:Template:Marines (infanterie de marine) et en:Template:Armed forces (forces armées).

Paramètres de documentation[modifier | modifier le code]

Ces paramètres sont utilisés uniquement pour l'affichage de la documentation (cela correspond à la partie située entre les balises <noinclude> et </noinclude>) :

var1 à var40
Indiquer le nom d'une variante
Documente l'existence d'une variante définie avec flag alias-variante.
Ce paramètre ne sert qu'à indiquer dans la documentation du modèle que la variante existe. La variante doit d'abord avoir été définie.
Exemple : var1 = libre
Jusqu'à 40 variantes peuvent être documentées ainsi.
redir1 à redir7
Documente l'existence d'une redirection vers le modèle country data.
Par exemple redir1 = FRA affichera dans la documentation qu'il existe une redirection de Modèle:Country data FRA vers Modèle:Country data France.
Ce paramètre ne sert qu'à indiquer que la redirection existe. La redirection doit être effectivement créée, et pointer vers le modèle pour que cela fonctionne.
Le fonctionnement est le suivant :
Ces redirections sont souvent issues, mais pas seulement, des abréviations standards des codes des pays telles que celles définies dans les normes ISO 3166-1 alpha-3 ou encore par le CIO, mais aussi les codes FIFA et certains codes postaux (par ex. États des États-Unis, provinces et territoires du Canada).
Les redirections sont également utilisées avec {{Pays}} pour afficher au choix comme texte du lien le nom d'un pays ou territoire sous sa forme courte ou longue. Il suffit de passer le nom correspondant voulu.
Par exemple {{Country data Carélie}} dispose d'une redirection {{Country data République de Carélie}}. Ce qui permet d'afficher, au choix :
related1 à related40
Permet de mentionner des modèles country data connexes (par exemple d'anciens pays ou des subdivisions territoriales).
À remplir sous la forme related1 = Québec pour Modèle:Country data Québec.
Parfois différents modèles country sont utilisés comme une solution alternative à un modèle country data commun pour un pays, que ce soit pour des raisons historiques ou en raison de la complexité de l'histoire d'un pays, fait de multiples entités, parfois plus ou moins indépendantes à un moment. Des liens vers ces modèles alternatifs sont des ajouts utiles à la documentation du modèle afin que les contributeurs puissent utiliser le modèle le plus approprié dans leurs cas.
cat
Permet de classer le modèle dans [[Catégorie:Modèle valeur_du_paramètre_cat]].
Exemple : cat = Allemagne classera le modèle dans Catégorie:Modèle Allemagne.
Si ce paramètre est omis et qu'il existe une catégorie de la forme [[Catégorie:Modèle shortname alias]], ou le cas échéant [[Catégorie:Modèle alias]], alors elle est utilisée par défaut.
Voir la section #Catégorisation pour plus d'informations sur la catégorisation des modèles Country data.
contenu
Permet d'écrire une courte documentation additionnelle personnalisée, par exemple pour donner des précisions sur des variantes.
Peut également être utilisé pour ajouter des catégories additionnelles.

Catégorisation[modifier | modifier le code]

Tous les modèles sont automatiquement catégorisés dans la catégorie Catégorie:Modèle Country data, avec une clé de tri correspondant au principe indiqué ci-dessous. Cette catégorisation n'est pas modifiable.

La clé de tri correspond à la valeur du premier des paramètres suivants qui sera présent dans le code, par ordre de priorité :

  1. Paramètre sortkey,
  2. Paramètre shortname alias,
  3. Paramètre alias.

Une catégorisation secondaire automatique a également lieu dans la catégorie des modèles spécifiques au pays concerné, selon le format suivant : [[Catégorie:Modèle <shortname alias>]], ou à défaut [[Catégorie:Modèle <alias>]]. Celle-ci est modifiable. Si aucune catégorie n'existe sous les deux noms précédents, la catégorisation secondaire n'est pas effectuée (cela ne pose pas de problèmes).

Pour modifier la catégorisation secondaire, il faut indiquer dans le paramètre cat le suffixe d'une catégorie de modèles. Par exemple pour la catégorie Catégorie:Modèle Country data Afrique du Sud, indiquer cat = Country data Afrique du Sud.

Pour la catégorisation secondaire, à moins que la catégorie indiquée dans cat ne commence par « Country data », la clé de tri correspond au nom du modèle, sans l'espace de nom « Modèle: ». Si le suffixe indiqué dans cat commence par « Country data », alors une clé de tri spécifique sera générée sur le même principe que pour la Catégorie:Modèle Country data indiquée plus haut.

Des catégories additionnelles peuvent êtres ajoutées si besoin dans le paramètre contenu, sous forme de wikicode normal (par exemple [[Catégorie:Modèle Country data Ancien état et entité territoriale|<clé de tri>]]. Il est nécessaire d'indiquer manuellement la clé de tri à utiliser. Si plusieurs catégories additionnelles doivent êtres ajoutées, les ajouter à la suite, collées les unes aux autres, sans ajouter d'espace entrent-elles.

Ajout d'une sous-page de documentation additionnelle[modifier | modifier le code]

Pour des cas où la documentation auto-générée serait insuffisante, une documentation additionnelle peut être affichée par {{Country showdata}}. En créant une sous-page de documentation (nommée selon Modèle:Country data Nom du pays/Documentation) contenant les informations supplémentaires, elle sera automatiquement transclue à la suite du contenu auto-généré.

Pour ajouter un texte court dans la documentation sans créer de sous-page dédiée, il est possible d'utiliser le paramètre contenu.

Exemple[modifier | modifier le code]

Code complet du Modèle:Country data Canada :

{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = Canada
| flag alias = Flag of Canada.svg
| alt attribute = Drapeau du Canada
| flag alias-1868 = Canadian Red Ensign 1868-1921.svg
| flag alias-1921 = Canadian Red Ensign 1921-1957.svg
| flag alias-1957 = Canadian Red Ensign 1957-1965.svg
| flag alias-naval = Naval Ensign of Canada.svg
| link alias-naval = Marine royale canadienne
| flag alias-naval-1921 = Canadian Blue Ensign 1921-1957.svg
| flag alias-naval-1957 = Canadian Blue Ensign 1957-1965.svg
| flag alias-air force = Canadian Air Command flag.svg
| link alias-air force = Aviation royale du Canada
| flag alias-air force-1924 = Ensign of the Royal Canadian Air Force.svg
| flag alias-army = Canadian Army Badge.svg
| link alias-army = Commandement de la Force terrestre des Forces canadiennes
| size = {{{size|}}}
| name = {{{name|}}}
| altlink = {{{altlink|}}}
| altvar = {{{altvar|}}}
| variant = {{{variant|}}}
<noinclude>
| var1 = 1868
| var2 = 1921
| var3 = 1957
| var4 = naval-1921
| var5 = naval-1957
| var6 = air force-1924
| related1 = Alberta
| related2 = Colombie-Britannique
| related3 = Manitoba
| related4 = Nouveau-Brunswick
| related5 = Terre-Neuve-et-Labrador
| related6 = Territoires du Nord-Ouest
| related7 = Nouvelle-Écosse
| related8 = Nunavut
| related9 = Ontario
| related10 = Île-du-Prince-Édouard
| related11 = Québec
| related12 = Saskatchewan
| related13 = Yukon
| redir1 = CAN
</noinclude>
}}

Principe de fonctionnement[modifier | modifier le code]

Le système country est formé d'un petit nombre de modèles de base et d'un modèle de données par pays. Chaque modèle de données contient les informations nécessaires à l'affichage du nom et du drapeau : nom de l'article, image du drapeau, taille standard du drapeau et clé de tri. Pour gérer un pays supplémentaire, il faut créer le modèle de données correspondant. Aucune modification des modèles de base n'est nécessaire (en particulier, ces modèles ne contiennent aucun switch listant tous les modèles existants pour contrôler la validité des paramètres).

Pour des raisons d'efficacité, le système country utilise un système de callback permettant d'extraire tous les paramètres en ne faisant qu'un appel au modèle. Chaque modèle de données prend en paramètre 1 le nom du modèle de « callback ». Par exemple, l'expansion de {{Country data France|Callback}} donne {{Callback|alias=France|flag alias=Flag of France.svg|...}}.

Ainsi, le système country possède trois niveaux de modèles :

Le premier paramètre d’un modèle country data est habituellement le nom d’un méta-modèle préformaté. Par exemple, Modèle:Drapeau utilise Modèle:Drapeau/callback pour générer l’icône du drapeau et le lien wiki. Si le premier paramètre est manquant, ce qui est le cas quand un modèle « country data » est affiché directement, le fragment de code du modèle {{{1<noinclude>|country showdata</noinclude>}}} provoque l'appel au modèle {{country showdata}}, qui est ainsi utilisé comme premier paramètre par défaut. Cette technique permet de s’assurer que tous les modèles country data sont auto-documentés s’ils utilisent la syntaxe standardisée.

Par exemple, en ne gardant que les éléments essentiels, l'expansion de {{Pays|France}} donne :

{{Country data France
 |Pays/callback
 |name = France
 |size = 20x18px
}}

Expansion du modèle de données :

{{Pays/callback
 | alias = France
 | alt attribute = Drapeau de la France
 | flag alias = Flag of France.svg
 | name = France
 | size = 20x18px
}}

Expansion du modèle de callback :

{{Tri1|1=France|2=
  <span class="flagicon">[[Fichier:Flag of France.svg|20x18px|border|Drapeau de la France]]&nbsp;</span>[[France|France]]
}}

Divers autres modèles sont aussi utilisés par le système country :

  • {{Pays/lien seul}} affiche un lien vers un pays à partir de son nom ou d'un code à trois lettres. Il est destiné aux modèles prenant en paramètre un nom de pays et affichant un drapeau et un lien non accolés, comme {{Jumelage}} ;
  • {{Pays-texte}} ;
  • {{Getalias}} extrait les données brutes des modèles country data : image du drapeau, titre de l'article, nom du pays ;
  • {{Country showdata}}, système de documentation automatique des modèles country data de pays, documente et affiche automatiquement les données d'un pays quand on consulte son modèle country.

Questions fréquentes[modifier | modifier le code]

Les variantes du drapeau ne fonctionnent pas[modifier | modifier le code]

Vérifier les points suivants :

  • Un paramètre | flag alias-variante = image.extension existe, et qu'il se trouve en dehors de la partie entourée de balises <noinclude>...</noinclude>.
    Exemple : | flag alias-1868 = Canadian Red Ensign 1868-1921.svg
  • Que cette variante est bien documentée avec un paramètre | varX = variante présent à l'intérieur des balises <noinclude>...</noinclude>.
    Exemple : | var1 = 1868
  • Que le paramètre passant | variant = {{{variant|}}} est bien présent dans le modèle (c'est par ce paramètre que transite le nom de la variante du drapeau), et qu'il se trouve également en dehors des balises <noinclude>...</noinclude>.
  • Que vous appelez bien dans l'article le modèle {{Pays}} ou {{Drapeau}}, et non directement un modèle de type « pays et drapeau » comme {{France}} ou {{Allemagne}}, qui ne supportent pas les variantes de drapeaux.
  • Que vous n'essayez pas d'utiliser une variante de drapeau avec un modèle {{Marine de guerre}}, {{Armée de l'air}} ou {{Armée de terre}}. Ces modèles ne gèrent pas les variantes de drapeaux. Voir #Paramètres pour les forces armées pour plus d'informations et les solutions de contournement.

Connaitre les pages utilisant une variante[modifier | modifier le code]

Il est possible de rechercher les pages et modèles utilisant une variante avec la recherche suivante, en mettant le code suivant dans le champ de Spécial:Recherche (ce code utilise des expressions régulières). Il suffit de remplacer les deux éléments indiqués en rouge (pays et variante) par les valeurs voulues :

all: hastemplate:"Country data pays" insource:/\{\{(Pays|Drapeau) *\|[^{}]+\| *variante *\}\}/i

Exemple avec le modèle country {{Country data Afrique du Sud}} et la variante 1928 :

all: hastemplate:"Country data Afrique du Sud" insource:/\{\{(Pays|Drapeau) *\|[^{}]+\| *1928 *\}\}/i

Essayer : all: hastemplate:"Country data Afrique du Sud" insource:/\{\{(Pays|Drapeau) *\|[^{}]+\| *1928 *\}\}/i

À noter que cette commande recherche d'abord tous les articles incluant le modèle {{Country data Afrique du Sud}} quelque part (même si appelé avec une redirection, et via un autre modèle). Puis recherche dans le wikicode de ces articles tous les modèles {{Pays}} et {{Drapeau}} ayant comme variante 1928 (quel que soit le nom du pays).

De ce fait la recherche retournera aussi bien les appels du genre {{drapeau|Afrique du Sud|1928}} que les {{drapeau|RSA|1928}}. Cela permet de prendre en compte les différentes redirections du modèle. En contrepartie, cela peut parfois retourner des faux-positifs si un modèle {{Pays}} ou {{Drapeau}} d'un autre pays est appelé dans la même page, avec une variante portant le même nom.

Voir Aide:Recherche et Aide:Recherche avancée pour plus d'informations sur les filtres de recherche hastemplate: et insource:.