Modèle:Étiquette/Documentation

Utilisation
Ce modèle de point place un contenu sur une carte. Il lie un terme à une localisation donnée par l'intermédiaire d'un trait. Un paramètre de positionnement permet de résoudre des problèmes de chevauchement ou de texte hors-cadre. Il facilite donc certains placements délicats de termes.
Ce modèle est semblable à {{Toponyme avec trait}} qui est adapté à la géolocalisation. {{Étiquette}} convient aux graphiques, planches, schémas, ...
On peut employer ce modèle pour la localisation en pixels en ajoutant unité=px, mais ce procédé est obsolète.
Il s'emploie à l'intérieur d'autres modèles comme {{début de carte}} ... {{fin de carte}} ou {{image annotée}} (voir aide:image complétée et aide:carte complétée).
Syntaxe
{{Étiquette/Documentation|1=y|2=x|3=contenu|4=extrémité|5=orientation|6=couleur|unité=|pas de point=}}
  • 1 : position verticale (sans l'unité) par rapport au bord supérieur de l'image (obligatoire).
  • 2 : position horizontale (sans l'unité) par rapport au bord gauche de l'image (obligatoire).
  • 3 : terme ; simple texte, lien ou formatage complexe (obligatoire).
  • 4 : position de l'autre extrémité du trait, donc du terme (cela permet de les aligner) ; cela correspond à une distance sans l'unité par rapport au bord de l'image (facultatif ; 0, c'est-à-dire le bord de l'image par défaut).
  • 5 : positionnement (orientation) du terme par rapport à la localisation donnée : n, ne, e, se, s, so (sw), o (w), no (nw) (facultatif ; ne par défaut).
  • 6 : couleur du trait (facultatif ; gris par défaut).
  • unité : unité pour les positions, en px ou % (facultatif ; % par défaut).
  • pas de point : le paramètre booléen qui précise si le point sera ou non affiché (facultatif ; un petit point est affiché par défaut).
Notes
  • Contrairement à l'habitude, les coordonnées sont (y, x) : 1=y, 2=x.
  • Il est fortement recommandé de numéroter le paramètre de contenu (avec 3=contenu) car cela évitera certains dysfonctionnements lorsque le contenu emploie des balises HTML.
  • Les traits sont toujours soit horizontaux (orientation e ou o) soit verticaux (dans tous les autres cas)
  • Le paramètre 4 indique la position de l'extrémité du trait
    • par rapport au bord haut pour les orientations (paramètre 5) n, ne, et no
    • par rapport au bord bas pour les orientations s, se et so
    • par rapport au bord gauche pour l'orientation o
    • par rapport au bord droit pour l'orientation e
  • Les lettres e, o ou rien du paramètre 5 indiquent l'alignement du texte par rapport à la fin du trait
    • alignement à gauche pour e
    • alignement à droite pour orientation o
    • centré si pas de précision
  • Les étiquettes peuvent déborder des images

Exemple

Code wiki Rendu
{{début de carte}}<!--
-->[[File:Blue compass rose.svg|250px]]
{{étiquette|20|50|nord(n)|10|n}}
{{étiquette|29|71|nord-est (ne)|10|ne}}
{{étiquette|50|80|est (e)|10|e}}
{{étiquette|71|71|sud-est (se)|10|se}}
{{étiquette|80|50|sud(s)|10|s}}
{{étiquette|71|29|sud-ouest (so)|10|so}}
{{étiquette|50|20|ouest (o)|10|o}}
{{étiquette|29|29|nord-ouest(no)|10|no}}
{{étiquette|75|10|10% bord gauche|25}}
{{étiquette|75|90|10% bord droit|25}}
{{fin de carte}}
nord(n)
nord-est (ne)
est (e)
sud-est (se)
sud(s)
sud-ouest (so)
ouest (o)
nord-ouest(no)
10% bord gauche
10% bord droit



Variante
Liste exhaustive des sous-modèles