Wikinews:Jargon/Modèle de point

Cette page décrit le "modèle de point". Pour une approche moins technique, voir la liste des modèles de point utilisables en paramètre. Pour une approche plus générale, voir la géolocalisation et ses tutoriels.

Définition modifier

Un modèle de point positionne par dessus une image, un point (un <truc>), avec un pictogramme et/ou un toponyme. Le point est toujours centré sur la position donnée. La syntaxe commune à ce type de modèles est : « {{<nom du modèle>|1=<y>|2=<x>|3=<toponyme>|<arg1>|<arg2>}} ». Ces modèles permettent de créer des cartes complétées, soit directement (localisation), soit indirectement en paramètre (pour le modèle « Modèle:Point/<Truc> », la valeur du paramètre est « <Truc> ») dans des modèles de géolocalisation tels que {{G}}, {{Géolocalisation}}, {{Carte avec géolocalisation}}, etc..

Description détaillée modifier

Modèles utilisables en paramètres et modèles génériques modifier

Les modèles de point utilisables en paramètres pour localiser un <truc> est typiquement

  1. « Modèle:Point/<Truc> sans toponyme » dans une infobox.
  2. « Modèle:Point/<Truc> » pour une carte complétée

La conception d'un modèle de point repose sur l'utilisation de modèle générique (ou méta-modèle) de point. La manière la plus simple de créer un nouveau modèle de point (pour localiser un nouveau truc) est d'employer un modèle générique (ou méta-modèle). On utilise le plus souvent :

  1. {{Pictogramme}} pour « Modèle:Point/<Truc> sans toponyme »
  2. {{Pictogramme avec toponyme}} pour « Modèle:Point/<Truc> »

Ou encore, soit {{Toponyme}}, soit {{Toponyme avec trait}} lorsque la localisation est plus floue ({{Point/Région}}, {{Point/Ile}} par exemple).

Syntaxe modifier

La syntaxe commune à ces modèles est :

{{<modèle de point>|1=<y>|2=<x>|3=<toponyme>|4=<arg1>|5=<arg2>|...}}
  • <y> et <x> sont les coordonnées du point par rapport au coin supérieur gauche de l'image sur laquelle le point apparaitra. Attention à l'inversion (y, x)[1].
  • <toponyme> est ...
  • pour les points nommés « <Truc> sans toponyme », le toponyme doit être un texte brut. Il n'apparait qu'en info-bulle du pictogramme.
  • pour les points nommés « <Truc> », le toponyme est un lien vers l'article. On peut employer la syntaxe « <titre de page>{{!}}<nom réel> ».

L'usage des paramètres suivant <arg1>, <arg2> dépend du modèle. Voir la liste des modèles de point.

Usage et mécanisme modifier

Ce type de modèles peut être utilisé directement entre les balises {{Début de carte}} et {{Fin de carte}}[2].

Toutefois, ce type de modèle est avant tout employé indirectement par le modèle {{G}}, {{G/dms}}, {{Géolocalisation}}, {{Carte avec géolocalisation}} ou encore {{Carte avec géolocalisation dans l'infobox}}. L'utilisation de

{{G|<carte>|<latitude>|<longitude>|<toponyme>|<nom du point>|6=<arg1>|7=<arg2>}}[3]

entraine un appel au modèle de point « Modèle:Point/<nom du point> » ainsi :

{{Point/<nom du point>|<y>|<x>|<toponyme>|4=<arg1>|5=<arg2>}}[4]

On note d'abord que les coordonnées géographiques (<latitude>, <longitude>) ont été converties en deux pourcentages (<y>, <x>) des dimensions de l'image[5], grâce au modèle de paramétrage de carte « Modèle:Géolocalisation/<carte> ».

On voit également que les paramètres <toponyme>, <arg1> et <arg2> sont directement transmis au modèle de point. L'usage du paramètre <toponyme> est commun à tous les modèles de point. En revanche, les paramètres <arg1> et <arg2> sont optionnels (ad lib. en quelques sortes). Leur utilisation (ou non-utilisation) dépend du modèle de point choisi.

Code modifier

La taille
Le modèle de point est centré lorsque les coordonnées <y>, <x> correspondent au centre du point et non à son coin supérieur gauche. Pour centrer un pictogramme de <taille> donnée, le modèle doit utiliser le code
<div style="position:absolute;border:none;
top:{{{1}}}%;left:{{{2}}}%;<!-- ... -->
"><div style="position:absolute;border:none;
top:{{#expr:-(<taille>)/2}}px; 
left:{{#expr:-(<taille>)/2}}px;<!-- ... -->
"><!-
...
--></div></div>
Voir {{Pictogramme}}. Avec une bordure, il faut également retrancher l'épaisseur de cette bordure.
Il faut également préférer les <taille> paires car elle sont mieux centrées lorsque les coordonnées sont entières.
Les paramètres <arg1> et <arg2>
Le traitement de ces paramètres est délicat. Il faut tenir compte du fait que le paramètre peut être, non seulement absent, mais également vierge. Si la valeur par défaut est vierge, on peut employer {{{4|}}} ou {{{5|}}} sans danger. Dans le cas contraire, l'usage simple de {{{4|<valeur par défaut>}}} n'est pas possible[6]. La bonne syntaxe est
{{#if:{{{4|}}}|{{{4}}}|<valeur par défaut>}}
Voir aussi

Comment créer un nouveau point ? modifier

Avant de créer un nouveau point utilisable en paramètre, voici divers points à prendre en compte :

  • Vérifier qu'il n'existe pas déjà un point pour votre truc. La liste exhaustive est le moyen le plus sur de s'en assurer.
  • Respectez la sémantique ! Ne pas créer de points alternatifs pour des raisons purement esthétiques. Le point actuel peut probablement être remanié.
  • Il est peut être préférable de paramétrer un point existant (comme cela est fait pour {{Point/Ville}}) pour prendre en compte des variantes.
  • L'emploi d'une modèle générique est fortement recommandé

Voici quelques codes types:

{{Point/Aéroport sans toponyme}} emploie {{Pictogramme}} :

<includeonly>{{Pictogramme|{{{1}}}|{{{2}}}
|3={{{3|}}}
|4=Airplane silhouette.svg
|5={{{4|12}}}}}</includeonly><noinclude>
{{Documentation de modèle de point}}
</noinclude>

{{Point/Aéroport}} emploie {{Pictogramme avec toponyme}} :

<includeonly>{{Pictogramme avec toponyme|{{{1}}}|{{{2}}}
|3=[[{{{3|toponyme manquant !}}}]]
|4=Airplane silhouette.svg
|5={{{4|ne}}}
|6=6
|7=12}}</includeonly><noinclude>
{{Documentation de modèle de point}}
</noinclude>

{{Point/Région}} emploie {{Toponyme}} :

<includeonly>{{Toponyme|{{{1}}}|{{{2}}}
|3=[[{{{3}}}|<span 
style="font-size:%200;font-weight:bold;color:#808080;"
>{{{3}}}</span>]]}}</includeonly><noinclude>
{{Documentation de modèle de point}}
</noinclude>

{{Point/Fleuve sans toponyme}} emploie {{Toponyme avec trait}} :

Ici on peut difficilement employé un pictogramme, on est bien obligé d'afficher le toponyme et on fait en sorte qu'il ne déborde pas du cadre.

<includeonly>{{Toponyme avec trait|{{{1}}}|{{{2}}}
|3=<span style="color:#0978AB;">{{{3|localisation du cours d'eau}}}</span>
|4=20|5={{#ifexpr: {{{1}}}<50|s|n}}{{#ifexpr: {{{2}}}<70
   |{{#ifexpr: {{{1}}}<30|e|}}|o}}}}</includeonly><noinclude>
{{Ébauche|modèle}}
{{Documentation de modèle de point}}
</noinclude>
Rechercher un pictogramme pour créer le nouveau point
Créer le nouveau point

Modèle:Créer un modèle de point

Sous-page d'information modifier

Le création d'un modèle de point « Modèle:Point/<point> » s'accompagne d'une sous-page d'information « Modèle:Point/<point>/Information » grâce à laquelle la documentation sera automatique généré par {{Documentation de modèle de point}}. Pour créer cette page, il suffit de cliquer le lien donnée après la création du modèle.

Note
Le procédé des sous-pages « Information » est similaire à celui des modèles de paramétrage de carte. Wikinews:Modèles/Points est également automatiquement générée grâce aux sous-pages d'information. Pour cela, il sera aussi demander d'ajouter le nouveau point à la liste.

Développements modifier

Voir quelques proposition à débattre :

Étoffer le jeu de modèles modifier

Les modèles de point sont encore trop peu nombreux. Par exemple, la géolocalisation de la centrale nucléaire de Balakovo demande un modèle de point spécifique {{Point/Site nucléaire}} afin que le pictogramme soit plus adapté.

Quelques modèles utiles :

Paramétrer les points modifier

Un paramètre de type peut être ajouter à certains points (de manière similaire à statut de la ville pour {{Point/Ville}}). Par exemple :

  1. la raison de l'inversion (y, x) tient à la correspondance avec (latitude, longitude).
  2. Techniquement parlant, ces modèles se placent à l'intérieur d'une balise HTML à laquelle on ajoute position:relative; à son attribut style. Mais un usage plus raisonnable consiste à employer systématiquement {{Début de carte}} et {{Fin de carte}}.
  3. Numéroter les paramètres n'est pas une nécessité ; mais c'est plus fiable.
  4. Noter qu'il y a un double décalage dans la numérotation des arguments car il n'y a plus de paramètres <carte> et <nom du point> dans le modèle de point.
  5. ... ou plus généralement, des dimensions de la boîte conteneur.
  6. Voir le BUG 1.

Annexes modifier

Voir aussi modifier