Template:Tag/doc

This is a documentation subpage for Template:Tag.
It contains usage information, categories and other content or metadata that is not part of the original template.

Ce modèle est utilisé pour représenter une donnée OpenStreetMap ou paire clé/valeur. Les éléments indiqués sont automatiquement liés aux pages appropriées du wiki OSM.

Ce modèle est alimenté par Module:Tag.

Usage

Le modèle peut être utilisé dans une grande variété de cas. Les usages les plus simples et courants sont :

Description	Exemple de wikitexte	Résultat
Une clé unique	{{Tag|highway}}	highway=*
Une paire clé/valeur spécifique	{{Tag|highway|residential}}	highway=residential
Une paire avec une valeur générique ou littérale (sans hyperlien)	{{Tag|bridge||yes}}	bridge=yes
Une clé avec la description d'une valeur	{{Tag|ref||''ref number''}}	ref=ref number

Clés composées

Certains noms de clés peuvent avoir plusieurs parties, souvent associées avec les namespaces des clés. C'est par exemple le cas des clés associées avec les fr:adresses :

addr:housenumber=* est utilisé pour indiquer le numéro de rue d'une maison,

addr:street=* est utilisé pour indiquer le nom d'une rue, etc.

Ce modèle permet de choisir différentes approches pour mettre en forme les clés composées : tandis que le texte lui-même reste identique, la manière dont les parties de la clé sont reliées entre elles diffère.

• Lien unique vers la page de sous-clé

  Cette approche considère la clé composée comme une unique entité, et pointe vers la page wiki décrivant cette clé composée :

  {{Tag|building:fireproof}}

  produit un lien unique vers la page wiki Key:building:fireproof, comme ceci :

  building:fireproof=*

  Cette approche est très utile lorsqu'une clé composée est décrite sur sa propre page, comme Key:building:fireproof ou Key:addr:flats.

• Lien unique vers la page de la clé principale:

  Le wikitexte suivant :

  {{Tag|addr|subkey=housenumber}}

  produit un unique lien vers la page wiki Key:addr, comme ceci :

  addr:housenumber=*

  Cette approche est très utile lorsqu'une série de sous-clés est décrite sur la page wiki de la clé principale, comme Key:addr.

• Liens multiples vers les pages des clés principales

  {{Tag|oneway|:=bicycle}}

  produit des liens séparés vers chacune des pages wiki des clés principales Key:oneway et Key:bicycle, comme ceci :

  oneway:bicycle=*

  et :

  {{Tag|cycleway|:=right|::=smoothness}}

  produit des liens séparés vers chacune des pages wiki des clés principales Key:cycleway, Key:right et Key:smoothness, comme ceci :

  cycleway:right:smoothness=*

  Cette approche est très utile lorsque chacune des parties de la clé est elle-même une clé principale, comme oneway:bicycle=*, où Key:oneway et Key:bicycle sont tous deux présents.

Valeurs multiples

Certaines clés peuvent comporter plusieurs valeurs indiquées, séparées par des points virgules. Ce modèle permet de spécifier autant de valeurs que souhaité, comme ceci :

Wikitexte d'exemple	Result
{{Tag|motor_vehicle|agricultural|;=forestry}}	motor_vehicle=agricultural;forestry
{{Tag|access|agricultural|;=forestry|;;=destination}}	access=agricultural;forestry;destination

Pour illustrer dans le wiki la présence de différentes valeurs et donner le lien vers chaque valeur (y compris l'utilisation de {{TagValue}}) :

Example wikitext	Result
{{Tag|wheelchair||({{TagValue|wheelchair|yes}}/{{TagValue|wheelchair|no}})}}	wheelchair=(yes/no)
{{Tag|motor_vehicle||({{TagValue|motor_vehicle|agricultural}}/{{TagValue|motor_vehicle|forestry}})}}	motor_vehicle=(agricultural/forestry)
{{Tag|access||({{TagValue|access|agricultural}}/{{TagValue|access|forestry}}/{{TagValue|access|destination}})}}	access=(agricultural/forestry/destination)

Liens par défaut vers les sites externes pour la valeur de certaines clés

Certaines clés comme wikipedia=*, wikidata=* ou website=* peuvent créer des liens externes. Dans ce cas, leur valeur renseignée dans le paramètre 3 sera affichée (au lieu d'afficher simplement une astérisque), ainsi que leur lien spécifique compte tenu de leur valeur.

Cependant, quand la valeur est l'URL complète d'un site Web, à la différence d'autres valeurs d'attributs (qui sont courtes en général), cette valeur est autorisée à retourner à la ligne quand elle est trop longue pour tenir sur une seule ligne (cela évite que des colonnes dans les tableaux dépassent une largeur raisonnable).

Seules certaines clés ont ce comportement :

Example wikitext	Result
{{Tag|wikipedia||fr:Paris}}	wikipedia=fr:Paris
{{Tag|wikipedia|subkey=fr||Paris}}	wikipedia:fr=Paris
{{Tag|wikipedia|subkey=en||Paris}}	wikipedia:en=Paris
{{Tag|wikidata||Q90}}	wikidata=Q90
{{Tag|operator:wikidata||Q90}}	operator:wikidata=Q90
{{Tag|website||http://www.paris.fr/}}	website=http://www.paris.fr/

Pour toutes les autres clés, le troisième paramètre est simplement affiché tel quel, sans tentative de conversion en lien externe. Cette fonction n'est également pas utilisée quand la valeur est renseignée dans le deuxième paramètre (où elle est utilisée pour générer des liens internes, si possible).

Liens vers les pages non anglaises

L'action par défaut du modèle est de lier vers les pages qui sont dans la même langue que la page actuelle. Cependant, il est possible de spécifier l'utilisation d'une langue différente.

Le paramètre kl est utilisé pour spécifier la langue de la cible du lien pour la clé.

Le paramètre vl est utilisé pour spécifier la langue du lien pour la valeur.

Dans tous les cas, un code de langue standard est utilisé.

Lorsqu'une clé contient plusieurs parties qui sont liées séparément, le paramètre kl: précise la langue pour la deuxième ligne, kl:: pour la troisième ligne, etc.

Lorsqu'une valeur contient plusieurs parties, le paramètre vl2 précise la langue pour le deuxième lien, vl3 pour le troisième lien, etc.

Les exemples suivants illustrent ceci :

Example wikitext	Result
{{Tag|kl=de|highway|motorway}}	highway=motorway
{{Tag|highway|vl=de|motorway}}	highway=motorway
{{Tag|highway|motorway|kl=de|vl=de}}	highway=motorway
{{Tag|cycleway|:=right|::=smoothness|excellent|kl=de|kl:=de|kl::=de}}	cycleway:right:smoothness=excellent

Modèle de données

This is the TemplateData for this template used by VisualEditor.
TemplateData for Tag

Displays key or key=value pair automatically linked to appropriate wiki pages

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
Key	1	Main key of the tag (the part before =) Example highway	Line	required
Value	2	A documented value of the key (the part after =) Example residential	Line	suggested
Freeform value or description	3	A description of the value which should not be linked as a value would be; second parameter should be undeclared for this to work.	Line	optional
Key page language	kl	Language code of the key description page Example de	Line	optional
Value page language	vl	Language code of the value description page Example de	Line	optional
Subkey	subkey subkey1	Key part described on the same page as the main key	Line	optional
Subkey 2	subkey2	Second key part described on the same page as the main key	Line	optional
Subkey 3	subkey3	Third key part described on the same page as the main key	Line	optional
Subkey 4	subkey4	Fourth key part described on the same page as the main key	Line	optional
Key component 2	:	Second key part described on a separate page	Line	optional
Key component 2 page language	kl:	Language code of the second key part description page Example de	Line	optional
Key component 3	::	Third key part described on a separate page	Line	optional
Key component 3 page language	kl::	Language code of the third key part description page Example de	Line	optional
Key component 4	:::	Fourth key part described on a separate page	Line	optional
Key component 4 page language	kl:::	Language code of the fourth key part description page Example de	Line	optional
Key component 5	::::	Fifth key part described on a separate page	Line	optional
Key component 5 page language	kl::::	Language code of the fifth key part description page Example de	Line	optional
Value 2	; subval	Second documented value	Line	optional
Value 2 page language	vl2	Language code of the second value description page Example de	Line	optional
Value 3	;; subval2	Third documented value	Line	optional
Value 3 page language	vl3	Language code of the third value description page Example de	Line	optional
Value 4	;;; subval3	Fourth documented value	Line	optional
Value 4 page language	vl4	Language code of the fourth value description page Example de	Line	optional
Value 5	;;;; subval4	Fifth documented value	Line	optional
Value 5 page language	vl5	Language code of the fifth value description page Example de	Line	optional
Language	lang	Language code of all the link targets Example de	Line	optional
Disable categorization	nocat	Assigning any value disables the template's category linking behavior Example yes	Boolean	optional

Voir aussi

• {{TagKey}} – Montre la clé uniquement
• {{TagValue}} – Montre la valeur uniquement
• {{Value}} – Mise en forme avec un fond bleu clair, ressemble à du code
• {{LL}} – Nom complet d'une page spécifique traduit dans la langue utilisée par la page affichée actuellement, similaire à ce modèle mais pour toutes les pages
• {{Role}} – Mise en forme avec un fond bleu clair, ressemble à du code
• {{Prefix}} – Pour montrer un préfixe
• {{Suffix}} – Pour montrer un suffixe