« Projet:Modèle/Système Country » : différence entre les versions
Contenu supprimé Contenu ajouté
Complément de la modification précédente (retouches légères) + ajout d'une partie du contenu transféré depuis Modèle:Country showdata/Documentation, que j'ai simplifié et réécrit (peu pratique d'avoir deux documentations incomplètes, chacune couvrant certains aspects), il est plus logique que les explications détaillées tout soient réunies ici dans la documentation centrale du système country |
|||
| (Une version intermédiaire par le même utilisateur non affichée) | |||
Ligne 1 :
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 ==
=== Lien vers un pays avec drapeau ===
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.
Ligne 17 ⟶ 15 :
* <code><nowiki>{{Pays|France|libre}}</nowiki></code> → {{Pays|France|libre}}
* <code><nowiki>{{Pays|France|royal}}</nowiki></code> → {{Pays|France|royal}}
=== Drapeau seul ===
Le modèle {{m|Drapeau}} affiche le drapeau d'un pays. Dans sa forme la plus simple, il prend comme seul paramètre le nom du pays :
* <code><nowiki>{{Drapeau|France}}</nowiki></code> → {{Drapeau|France}}
Ligne 30 ⟶ 25 :
* <code><nowiki>{{Drapeau|Allemagne|taille=30}}</nowiki></code> → {{Drapeau|Allemagne|taille=30}}
===
{{Aide détaillée|Aide:Modèle pays et drapeau}}
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 : <code>Modèle:Country data ''Nom du pays''</code> (exemple pour l'Afrique du Sud : <code>[[Modèle:Country data Afrique du Sud]]</code>).
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 ===
Les modèles {{m|Armée de terre}}, {{m|Armée de l'air}} et {{m|Marine de guerre}} permettent de créer un lien vers les forces terrestres, aériennes et navales d'un pays.
Exemples :
Ligne 39 ⟶ 41 :
* <code><nowiki>{{Marine de guerre|Canada}}</nowiki></code> → {{Marine de guerre|Canada}}
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]] ([[Infanterie de marine|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 ==
Pour chaque pays, le système country a besoin d'un <code>Modèle:Country data ''Nom du pays''</code>. 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 ===
Syntaxe minimale d'un modèle <code>Modèle:Country data ''Nouveau pays''</code> pour que <code>{{m|Drapeau|''Nouveau pays''}}</code> et <code>{{m|Pays|''Nouveau pays''}}</code> marchent (ne définit ni variante, ni clé de tri personnalisée) :
<nowiki>{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = </nowiki>'''''Titre de l'article sur le pays'''''<nowiki>
| size = {{{size|}}}
}}</nowiki>
Syntaxe complète :
<nowiki>{{
| 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'''''<nowiki>
| 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'''''<nowiki>
}}</nowiki>
=== Paramètres
==== Paramètres de données standards ====
* <code>alias</code> est le nom de l'article sur le pays, par exemple « Luxembourg (pays) ».
* <code>shortname alias</code> est le nom du pays, par exemple « Luxembourg ». Il peut être omis si la cible du lien est la même que le texte du lien.
* <code>alt attribute</code> est l'[[:en:alt attribute|attribut alt]] du drapeau, par exemple « Drapeau du Luxembourg ». Facultatif, égal à « Drapeau : ''nom du pays'' » si non précisé.
* <code>flag alias</code> doit contenir le nom d'une image, sans lien et sans le préfixe « Fichier: ». Pour la plupart des pays, l'image du drapeau est nommée <code>Flag of ''nom du pays en anglais''.svg</code>, par exemple
* <code>flag alias-''variante''</code> a le même format que <code>flag alias</code> et sert à définir les drapeaux des variantes. Par exemple,
* <code>sortkey</code> Permet de définir une éventuelle clé de tri personnalisée pour le classement du modèle dans la [[:Catégorie:Modèle Country data]].
==== Paramètres pour les forces armées ====
Ces paramètres spéciaux sont utilisés par les modèles {{m|Marine de guerre}}, {{m|Armée de l'air}} et {{m|Armée de terre}}.
À noter qu'il n'y a pas besoin de documenter ces variantes, les drapeaux concernés sont automatiquement documentés.
** <code>flag alias-naval</code> : Contiens l'image du pavillon de la marine de guerre (optionnel si pavillon identique au drapeau du pays).
** <code>link alias-naval</code> : Contiens le nom de l'article consacré à la marine de guerre.
* Armée de l'air ({{m|Armée de l'air}})
** <code>flag alias-air force</code> : Contiens l'image du drapeau de l'armée de l'air (optionnel si drapeau identique à celui du pays).
** <code>link alias-air force</code> : Contiens le nom de l'article consacré à l'armée de l'air.
* Armée de terre ({{m|Armée de terre}})
** <code>flag alias-army</code> : Contiens l'image du drapeau de l'armée de terre (optionnel si drapeau identique à celui du pays).
** <code>link alias-army</code> : Contiens le nom de l'article consacré à l'armée de terre.
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 <code>{{m|Drapeau}}</code> (par exemple <code><nowiki>{{Drapeau|Afrique du Sud|military}}</nowiki></code> affichera {{Drapeau|Afrique du Sud|military}}).
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 :
** <code>flag alias-marines</code> : Contiens l'image du drapeau de l'infanterie de marine (optionnel si drapeau identique à celui du pays).
** <code>link alias-marines</code> : Contiens le nom de l'article consacré à l'infanterie de marine (<u>aucun utilisation du contenu de ce paramètre actuellement</u>).
* Garde-côtes :
** <code>flag alias-coast guard</code> : Contiens l'image du pavillon des garde-côtes (optionnel si pavillon identique au drapeau du pays).
** <code>link alias-coast guard</code> : Contiens le nom de l'article consacré à la garde-côtière (<u>aucun utilisation du contenu de ce paramètre actuellement</u>).
* Forces armées :
** <code>flag alias-military</code> : Contiens l'image du drapeau des forces armées du pays (optionnel si drapeau identique à celui du pays).
** <code>link alias-military</code> : Contiens le nom de l'article consacré aux forces armées du pays (<u>aucun utilisation du contenu de ce paramètre actuellement</u>).
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 ====
Ces paramètres sont utilisés uniquement pour l'affichage de la documentation (cela correspond à la partie située entre les balises <code><nowiki><noinclude></nowiki></code> et <code><nowiki></noinclude></nowiki></code>) :
* <code>var1</code> à <code>var40</code> : Documente l'existence d'une variante, par exemple, <code>var1 = libre</code> (mettre ce paramètre <code>var''X''</code> ne sert qu'à indiquer que la variante existe. La variante doit être définie avec un paramètre <code>flag alias-''variante''</code> pour que ça marche). Jusqu'à 40 variantes peuvent être documentées ainsi {{Avertissement|niveau=neutre|icône=OOjs UI icon notice-progressive.svg|texte=Notez que les drapeaux des variantes militaires spéciales <code>flag-alias-naval</code>, <code>flag-alias-air force</code>, <code>flag-alias-army</code>, <code>flag-alias-marines</code>, <code>flag-alias-coast guard</code> et <code>flag-alias-military</code> n'ont pas besoin d'êtres documentés ainsi, car ils sont détectés et documentés automatiquement.}}
* <code>redir1</code> à <code>redir''7''</code> : Documente l'existence de redirections vers le modèle country data. Par exemple, <code>redir1 = FRA</code> affichera dans la documentation qu'il existe une redirection de [[Modèle:Country data FRA]] vers [[Modèle:Country data France]]. Ces redirections sont utilisables à la place du nom du pays dans tous les modèles du système country : <code>{{m|Drapeau|FRA}}</code> est équivalent à <code>{{m|Drapeau|France}}</code> (mettre ce paramètre <code>redir''X''</code> ne sert qu'à indiquer que la redirection existe. La redirection doit être effectivement créée pour que ça marche). 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|ISO 3166-1 alpha-3]] ou encore par le [[Liste des codes pays du CIO|CIO]] mais aussi les codes [[Liste des codes pays de la FIFA|FIFA]] et certains codes postaux (par ex. états des États-Unis, provinces et territoires du Canada).
* <code>related1</code> à <code>related40</code> : Permet de mentionner des modèles country data connexes (par exemple d'anciens pays ou des subdivisions territoriales). À remplir sous la forme <code>related1 = Québec</code> 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 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.
* <code>cat</code> permet de classer le modèle dans <code><nowiki>[[</nowiki>Catégorie:Modèle ''valeur_du_paramètre_cat''<nowiki>]]</nowiki></code>. Par exemple, <code>cat = Allemagne</code> 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 <code><nowiki>[[</nowiki>Catégorie:Modèle ''shortname alias''<nowiki>]]</nowiki></code>, ou sinon le cas échéant <code><nowiki>[[</nowiki>Catégorie:Modèle ''alias''<nowiki>]]</nowiki></code>, elle est utilisée par défaut.
* <code>contenu</code> : Permet d'écrire une courte documentation additionnelle personnalisée, par exemple pour donner des précisions sur des variantes.
==== Ajout d'une sous-page de documentation additionnelle ====
Pour des cas où la documentation auto-générée serait insuffisante, une documentation additionnelle peut être affichée par <code>{{m|Country showdata}}</code>. En créant une sous-page de documentation (nommée selon <code>Modèle:Country data ''Nom du pays''/Documentation</code>) 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'ajouter un paramètre <code>contenu = ''Contenu additionnel''</code>.
=== Exemple ===
Code complet du [[Modèle:Country data Canada]] :
<pre>
{{ {{{1<noinclude>|country showdata</noinclude>}}}
Ligne 114 ⟶ 149 :
| 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>
Ligne 121 ⟶ 167 :
| 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>
Ligne 127 ⟶ 189 :
== Principe de fonctionnement ==
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 [[Fonction de rappel|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 <code>{{((}}Country data France|''Callback''{{))}}</code> donne <code>{{((}}''Callback''|alias=France|flag alias=Flag of France.svg|...{{))}}</code>.
Ainsi, le système country possède trois niveaux de modèles :
* les modèles à usage externe
* les modèles de données
* les modèles de 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 <code><nowiki>{{{1<noinclude>|country showdata</noinclude>}}}</nowiki></code> provoque l'appel au modèle {{m|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 <code>{{((}}Pays|{{Vert|''France''}}{{))}}</code> donne :
{{((}}Country
|
|name = {{Vert|''France''}}
|size = {{Bleu|''20x18px''}}
{{))}}
Expansion du modèle de données :
{{((}}{{Bleu|''Pays/callback''}}
| alias = {{Violet|''France''}}
| alt attribute = {{Violet|''Drapeau de la France''}}
| flag alias = {{Violet|''Flag of France.svg''}}
| name = {{Vert|''France''}}
| size = {{Bleu|''20x18px''}}
{{))}}
Expansion du modèle de callback :
{{((}}Tri1|1=France|2=
{{))}}
Divers autres modèles sont aussi utilisés par le système country :
* {{m|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 {{m|Jumelage}} ;
* {{m|Pays-texte}} ;
* {{m|Getalias}} extrait les données brutes des modèles country data : image du drapeau, titre de l'article, nom du pays ;
* {{m|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.
== Notes ==
{{Crédit d'auteurs|interne|Modèle:Country showdata/Documentation|142358142}}
== Voir aussi ==
* [[Projet:Drapeaux]]
* [[Aide:Modèle pays et drapeau]]
{{Projet|Modèle}}
[[Catégorie:Projet:Modèle]]
| |||