Extension:Graph/Guide/fr

Cette page est destinée à la communauté pour partager les meilleures pratiques sur l'utilisation de l'extension. Voir aussi le .



Organiser les graphiques dans un wiki


Séparez les graphiques des articles
Même si les graphiques peuvent être placés à l'intérieur de l'article, il est de loin préférable de les intégrer sous forme de modèles séparés, comme par exemple Template:Graph:&lt;yourgraphname&gt; qui peut être inséré avec



Personnaliser les graphiques
Même si vous pouvez intégrer les paramètres du graphique directement dans le graph, généralement ce n'est pas une bonne idée de faire ainsi. Les graphiques doivent être conçus comme des modèles flexibles qui peuvent être réutilisés dans plusieurs articles avec des ensembles de données et un style différents. Par exemple, même si la largeur et la hauteur du graphique peuvent être codées en dur :

il devrait être écrit comme un modèle de paramètres avec des valeurs par défaut, permettant une personnalisation facile :



Séparez les données du graphique

 * Tout comme pour le style ci-dessus, les données elles-mêmes ne doivent pas être stockées dans le graphique. Considérons une page avec un grand tableau qui peut être présentées dans un graphique, par exemple le liste des toiles les plus chères. La page contient un tableau assez complexe avec des données :

L'approche la plus simple pour construire un graphique consiste à extraire les données utiles et à placer le graphique avec ces données à côté du tableau. Même si cela fonctionne, cette approche n'est pas très bonne car il y a deux copies des mêmes données qui devront  être mises à jour  après chaque  changement. De plus, si le graph se trouve à l'intérieur du texte, l'article s'allonge et cumule du texte, du code et des données - moins de personnes pourront le modifier. Si le graphique est placé dans un modèle séparé, les rédacteurs sont plus susceptibles d'oublier de le mettre à jour lorsqu'ils modifient les données.

La solution adéquate, même si elle est un peu plus difficile à mettre en place au début, offrira un cheminement beaucoup plus sûr et plus facile à gérer, et pourra être réutilisée pour ce genre de liste.


 * 1) Créer une page séparée avec les données brutes, de préférence au format JSON. La structure de ce fichier est déterminée par les données nécessaires à la liste.
 * 2) Créer un module Lua avec une fonction qui convertit ces données brutes en une table wiki bien formatée.
 * 3) Dans le même module Lua, créez une autre fonction qui extrait les données nécessaires au graphique et les affiche sous forme de données au format JSON.
 * 4) Créer le modèle de graphique qui peut utiliser les données ci-dessus et le tracer.
 * 5) Enfin, insérez ces deux éléments dans la page de la liste :

Insérer un tableau bien formaté avec des données :

Insérer un graphique avec les mêmes données :



Données externes
Les données du graphique peuvent être intégrées dans la définition du graphique, ou fournies via un lien. Contrairement à la balise Vega standard, la balise du graphique nécessite que tous les liens externes utilisent l'un des protocoles personnalisés du wiki :

Par exemple, cet ensemble de données sera passé au graphe dans ce format :
 * - Récupère les ensembles tabulaires de Commons. Doit être utilisé avec  (ou "meta" ou "fields"). Les données passées au graphe sont déjà traduite dans la langue du wiki.


 * - Récupère l'ensemble de données cartographiques de Commons. Doit être utilisé avec  (on peut aussi utiliser "meta" pour obtenir la même information que pour tabular). Les données passées au graphe sont déjà traduite dans la langue du wiki.
 * - Récupère l'image File:Einstein_1921.jpg à partir de Commons pour une marque d'image. Il est toujours recommandé d'ajouter  (et / ou height) pour que l'image ait la bonne taille et pour réduire la charge du serveur.
 * OBSOLETE, use wikifile: instead  - Donne une image pour le graphique, par exemple de Commons. Cette balise précise tout contenu provenant du domaine des téléversements uploads.*, sans paramètre de requête. Utilisez le mot-clé magique  pour obtenir le chemin du fichier et la taille optionnelle de l'image.
 * - Donne le contenu brut d'une page de wiki, où le chemin d'accès est le titre de la page. Le domaine est facultatif et, s'il est spécifié, peut être n'importe quel hôte Wikimedia tel que fr.wikipedia.org, commons.wikimedia.org, ...
 * - Récupère les données à partir de l'API MediaWiki. Le domaine est facultatif.
 * - Appelez l'API RESTbase. Le domaine est facultatif.
 * ou  - Obtenir les représentations cartographiques (comme le Topojson) de régions données, en utilisant les ID Wikidata, ou une requête  URL encodée (dans SPARQL), avec la colonne "id" spécifiant les formes géographiques voulue.
 * - Fait un lien avec le service de photographie cartographique, de sorte qu'une carte statique peut être dessinée pour un lieu/ un zoom/une taille donné. Les paramètres sont convertis en une demande d'image pour Kartotherian - https://maps.wikimedia.org/img/{style},{zoom},{lat},{lon},{width}x{height}@2x.png



Exemples de graphique avec des données externes
Pour voir des exemples fonctionnels de json graph utilisant des données externes vous pouvez utiliser le paramètre debug= des modèles Template:Graph:Lines et Template:Graph:Stacked. Invocation d'un modèle ci-dessous, à titre d'exemple

va générer le json cohérent de graph



Problèmes fréquents


Rappel sur les paramètres des modèles imbriqués
Les modèles exigent que vous sépariez les paramètres des modèles imbriqués par au moins un caractère, sinon le graphique ne s'affichera tout simplement pas et vous obtiendrez une erreur de syntaxe. Faites attention !



Utilisation d'accolades doubles dans les graphiques
Vega 2 prend en charge les paramètres des modèles, tels que, mais MediaWiki tentera de trouver le modèle "indexDate" pour l'inclure (transclure). Pour éviter cela, utilisez \u007b au lieu de la première accolade, \u007d au lieu de la dernière accolade de fermeture, et le | au lieu du symbole de pipe " " :

Débogage

 * Le meilleur endroit pour développer et déboguer est dans le Bac à sable de Graph. Copiez le code JSON pour voir le graphique changer en temps réel pendant que vous tapez. Le bac à sable de Graph  comprend les commentaires de JSON et étend le balisage du wiki.  Voir le panneau inférieur droit pour le JSON converti.
 * Pour obtenir le graphique JSON à partir d'un modèle, alors que le graphe est en train de s'afficher, utilisez le terme correspondant dans la console de débogage du navigateur (cliquez pour afficher le Json). Si la page contient plus d'un graphique, incrémentez  jusqu'à obtenir celui que vous souhaitez. Supprimez le premier et le dernier apostrophe, puis faites un copier / coller dans l'éditeur Vega ci-dessus.


 * Dans Google Chrome, ceci copie la chaîne de caractères directement dans le presse papiers :


 * Vous pouvez aussi utiliser le débogueur du navigateur pour inspecter le graphique qui vous intéresse (même s'il ne s'affiche pas) - vous devriez voir quelque chose de similaire à . Copiez la valeur du hachage, appuyez sur escape (dans Chrome) et utilisez ce bon mot pour afficher le code  JSON (remplaçant la valeur de hachage par la votre). Supprimez le premier et le dernier apostrophe, puis faites un copier/coller dans l'éditeur Vega au dessus.