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 :


 * - Gets tabular dataset from Commons. Should be used with  (or "meta" or "fields"). The data given to the graph is already localized to the wiki language.

For example, this dataset would be given to the graph in this format:


 * - Gets map dataset from Commons. Should be used with  (can also use "meta" to get the same information as for tabular). The data given to the graph is already localized to the wiki language.
 * - Gets File:Einstein_1921.jpg image from Commons for an image mark. It is always recommended to add  (and/or height) to make the image the right size and reduce server load.
 * OBSOLETE, use wikifile: instead  - Donne une image pour le graph. Cette balise précise tout contenu provenant du domaine uploads.*, sans paramètre de requête. Utilisez le mot-clé magique  chemin de fichier  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, ...
 * - Donne les données à partir de l'API API MediaWiki. Le domaine est facultatif.
 * - Appelez l' API RESTbase. Le domaine est facultatif.
 * or  - 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

Examples of charts with external data
To see working example of graph json which uses external data it is possible to use Template:Graph:Lines and Template:Graph:Stacked template's debug= parameter. For example below template invocation

will produce following graph consistent json



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, cliquez sur "edit / page preview", et utilisez le débogueur du navigateur pour inspecter le graphique (même s'il ne s'affiche pas) - vous devriez voir le $code . Copiez la valeur du hachage, appuyez sur escape (dans Chrome) et utilisez ce lien pour afficher le code  JSON. Supprimez la première et la dernière cote, puis faites un copier/coller dans l'éditeur Vega au dessus.
 * To get the graph JSON from a template, while the graph is being displayed, use the following oneliner in the browser's debugger console (hit to show the JSON. If there is more than one graph on the page, increment the  until you get the one you want. Remove first and last quote, and copy/paste to the Vega editor above.


 * In Google Chrome, this will copy the string directly onto the clipboard :


 * You can also use browser's debugger to inspect the graph you are interested in (even if it is not showing) - you should see something like . Copy the hash value, hit escape (in Chrome), and use this oneliner to show the JSON (replacing the shown hash value with your own). Remove first and last quote, and copy/paste to the Vega editor above.