Projet:Modèle/Système Country
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
modifierLien vers un pays avec drapeau
modifierPour 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 :
{{France}}
→France
{{États-Unis}}
→États-Unis
{{Union soviétique}}
→Union soviétique
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}}
→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}} :
Drapeau seul
modifierLe 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 :
Comme le modèle {{Pays}}, on peut indiquer une variante et changer la taille :
Variantes de drapeaux disponibles
modifierPour 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
modifierLes 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 :
{{Armée de terre|Canada}}
→Armée canadienne
{{Armée de l'air|Canada}}
→Aviation royale canadienne
{{Marine de guerre|Canada}}
→Marine royale canadienne
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
modifierPour 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
modifierSyntaxe 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
modifierParamètres de données standards
modifieralias
- 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 :
flag alias-1928 = Flag of South Africa (1928–1982).svg
pour gérer{{Pays|Afrique du Sud|1928}}
et{{Drapeau|Afrique du Sud|1928}}
.flag alias-libre = Flag of Free France (1940-1944).svg
pour gérer{{Pays|France|libre}}
et{{Drapeau|France|libre}}
.
- 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é :
- Paramètre
sortkey
, - Paramètre
shortname alias
, - Paramètre
alias
.
- Paramètre
Paramètres pour les forces armées
modifierCes 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 ).
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
modifierCes 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 :
- Pour le modèle {{Drapeau}}, cela se comporte comme une simple redirection.
{{Drapeau|FRA}}
est équivalent à{{Drapeau|France}}
; tous deux afficheront «».
- Pour le modèle {{Pays}}, le nom de la redirection utilisée correspondra au texte affiché du lien. À savoir que
{{Pays|FRA}}
affichera «FRA », et
{{Pays|France}}
affichera «France ».
- Pour le modèle {{Drapeau}}, cela se comporte comme une simple redirection.
- 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 :
{{Pays|Carélie}}
affichera : «Carélie »,
{{Pays|République de Carélie}}
affichera : «République de Carélie ».
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
modifierTous 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é :
- Paramètre
sortkey
, - Paramètre
shortname alias
, - 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
modifierPour 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
modifierCode 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
modifierLe 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 :
- les modèles à usage externe : {{Pays}}, {{Drapeau}}, {{Armée de terre}}, ...
- les modèles de données comme {{Country data France}}
- les modèles de callback : {{Pays/callback}}, {{Drapeau/callback}}, {{Armée de terre/callback}}, ...
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]] </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
modifierLes variantes du drapeau ne fonctionnent pas
modifierVé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
modifierIl 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
À 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:
.
Notes
modifier- Cet article est partiellement ou en totalité issu de l'article intitulé « Modèle:Country showdata/Documentation » (voir la liste des auteurs).