Extension:Graph/Guide/fr

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Graph/Guide and the translation is 100% complete.
Other languages:
English • ‎Türkçe • ‎français • ‎中文 • ‎日本語 • ‎한국어

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

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:<yourgraphname> qui peut être inséré avec

{{Graph:<yourgraphname>}}

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 :

"width": 400, "height": 200,   // bad design

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

{{#tag:graph|{
    ...
    "width": {{{width|400}}}, "height": {{{height|200}}},   // good design
    ...
} }}

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 :
{|
! Price 
! Painting 
! Image 
! Artist 
! Year 
! ...
|-
! data-sort-value="$300"|~$300
| ''[[When Will You Marry?|Nafea Faa Ipoipo (When Will You Marry?)]]''
| [[File:Paul Gauguin, Nafea Faa Ipoipo? (When Will You Marry?) 1892, oil on canvas, 101 x 77 cm.jpg|95px]]
| {{sort|Gaugin, Paul|[[Paul Gauguin]]}}
| 1892
...
|}

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 :

{{#invoke:MyLuaModule|BuildTable|PageWithSourceData|...}}

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

{{Graph:MyGraph | {{#invoke:MyLuaModule|ExtractGraphData|PageWithSourceData|...}} }}

Données externes

Les données du graphique peuvent être intégrées dans la définition du graphique, ou fournies via un lien "url". 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 :

  • tabular:///PageWithTabularDataOnCommons.tab - Gets tabular dataset from Commons. Should be used with "format": {"type": "json", "property": "data"} (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:

{
  "meta": [{
    "description": "Women's weekly earnings as a percent of men's by age, annual averages",
    "license_code": "CC0-1.0+",
    "license_text": "Creative Commons Zero",
    "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
    "sources": "Copied from [https://www.bls.gov/opub/ted/2006/oct/wk1/art02.txt bls.gov] (United States Department of Labor)"
  }],

  "fields": [{
    "name": "year",
    "type": "number",
    "title": "Year"
  }, {
    "name": "age_16_24",
    "type": "number",
    "title": "16–24 y/o"
  }, ... ],

  "data": [{
    "year": 1979,
    "age_16_24": 78.5,
      ...
  }, ...]
}
  • map:///PageWithGeoJsonDataOnCommons.map - Gets map dataset from Commons. Should be used with "format": {"type": "json", "property": "data.features"} (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.
  • wikifile:///Einstein_1921.jpg - Gets File:Einstein_1921.jpg image from Commons for an image mark. It is always recommended to add ?width=... (and/or height) to make the image the right size and reduce server load.
  • OBSOLETE, use wikifile: instead wikirawupload:{{filepath:Albert Einstein photo 1921.jpg}} - 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.
  • wikiraw:///Article%20title/subpage - 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, ...
  • wikiapi:///?action=query&list=allpages - Donne les données à partir de l'API API MediaWiki. Le domaine est facultatif.
  • wikirest:///api/rest_v1/page/... - Appelez l' API RESTbase. Le domaine est facultatif.
  • geoshape:///?ids=408,664 or geoshape:///?query=SELECT... - 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.
  • mapsnapshot:///?width=__&height=__&zoom=__&lat=__&lon=__ [&style=__] - 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

Problèmes fréquents

Rappel sur les paramètres des modèles imbriqués

Les templates exigent que vous sépariez les paramètres des templates 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 !

Dans l'exemple :

will not render : ne s'affiche pas.

will render, notice the whitespace in the closing braces : s'affiche, remarquez l'espace blanc dans les accolades de fermeture

"values": {{{1|{{#invoke:Graph:Utils|expandDict|{"BR":"pink","US":"blue"} }}}}} // will not render
"values": {{{1|{{#invoke:Graph:Utils|expandDict|{"BR":"pink","US":"blue"} }} }}} // will render, notice the whitespace in the closing braces

Utilisation d'accolades doubles dans les graphiques

Vega 2 prend en charge les paramètres des modèles, tels que "template": "{{indexDate | time: '%b %Y'}}", 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 "|" : "template": "\u007b{indexDate {{!}} time: '%b %Y'}\u007d"

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 <div class="mw-graph ... data-graph-id="834d6921e69e66a00b40d8606e39e414145f8288" ... . 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.
JSON.stringify(mw.config.get('wgGraphSpecs')['834d6921e69e66a00b40d8606e39e414145f8288'])