Manuel des extensions MediaWiki

Chart État de la version : stableCategory:Stable extensions/fr
Implémentation	Balise Category:Tag extensions/fr
Description	Renders charts
Auteur(s)	TODO
Politique de compatibilité	Le master conserve la compatibilité arrière.
MediaWiki	>= 1.45
Modifie la base de données	Non
Licence	Licence publique générale GNU v3.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (Phabricator · GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source Category:Extensions in Wikimedia version control/fr README
Paramètres $wgChartRequestSizeLimit $wgChartProgressiveEnhancement $wgChartTransformsEnabled $wgChartServiceUrl $wgChartCliPath
Accroches utilisées LinksUpdateComplete Category:LinksUpdateComplete extensions/fr PageSaveComplete Category:PageSaveComplete extensions/fr ParserFirstCallInit Category:ParserFirstCallInit extensions/fr
Traduire l’extension Chart sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension Chart fournit des capacités de visualisation de données interactives de base conçues pour remplacer certains aspects, mais pas tous, de l'extension Graph . Cette extension est actuellement en développement pour les wikis Wikimedia. Voir Extension:Chart/Projet pour plus de détails sur le processus de développement.

Cette extension prend en charge les types de graphiques suivants :

• Graphique linéaire
• Graphique en aires
• Diagramme en barres
• Diagramme circulaire

Installation

L'extension Chart nécessite l'installation de l'extension JsonConfig ainsi que le téléchargement de la bibliothèque JavaScript Chart Renderer (actuellement la bibliothèque TypeScript).

Voir le fichier README.md dans le dépôt pour les instructions de configuration complètes.

Pour l'utilisation pour Wikimedia, voir wikitech:Kubernetes/Deployments pour les instructions générales sur les déploiements de services.

Comment l'utiliser

Pour générer un graphique, une définition de graphique à associer à la source des données que vous souhaitez utiliser doit être réalisée. Une définition de graphique est structurée comme un fichier JSON relativement simple; voir Extension:Chart/Specification pour les détails de syntaxe.

Tous les graphiques de cet exemple peuvent être générés à partir de la même source de données : Data:Chart Example Data.tab, un ensemble de données fictif. Les exemples de contenu de ces pages sont disponibles dans le répertoire sample.

{
    "license": "CC0-1.0",
    "version": 1,
    "source": "Chart Example Data.tab",
    "type": "line",
    "title": {
        "en": "Example Chart Title"
    },
    "subtitle": {
        "en": "Example Subtitle"
    },"xAxis": {
        "title": {
        	"en": "Example X Axis Title"
        },
        "format": "none"
    },
    "yAxis": {
        "title": {
            "en": "Example Y Axis Title"
        },
        "format": "none"
    },
    "mediawikiCategories": [
        {
            "name": "Example category",
            "sort": "Its sortkey"
        }
    ],
    "transform": {
        "module": "Optional lua module for data transforms",
        "function": "transform_func",
        "args": {
            "arg_name": "arg_value"
        }
    }
}

Une fois un graphique défini, vous pouvez le générer facilement en utilisant la fonction d'analyse syntaxique #chart. Dans ce cas, les données du graphique sont définies en Data:Chart Example Data.tab, et le graphique lui-même est défini en Data:Example.Line.chart :

{{#chart:Example.Line.chart}}

Notez qu'un graphique peut être générique et réutilisé avec différentes données sources, comme ci-dessous :

{{#chart:Population through years.chart
|data=Population of USA.tab
}}

{{#chart:Population through years.chart
|data=Population of UK.tab
}}

{{#chart:Population through years.chart
|data=Population of Poland.tab
}}

Personnalisation

La personnalisation des graphiques est actuellement limitée. L'espoir est qu'après les tests, les discussions et les évaluations, des solutions de personnalisation puissent être trouvées qui ne compromettent pas l'accessibilité, le rendu spécifique à l'appareil ou la sécurité.

Internationalisation

Les graphiques ne peuvent être intégrés que dans le langage du contenu du wiki; par exemple, la chaîne de requête "uselang" (par exemple ?uselang=es) n'aura pas d'impact sur le graphique.

Le format du graphique prend en charge la définition de texte comme le titre et les étiquettes dans différentes langues, de sorte que le même graphique peut être utilisé dans les wikis de différentes langues. Voir cet exemple d'un graphique avec support pour plusieurs langues affiché dans un wiki en espagnol.

Types de graphiques

Pour tous les graphiques, les données doivent être disposées en colonnes, la première colonne représentant le x-axis et les colonnes suivantes représentant les séries ou courbes sur le y-axis.

{{image frame
|content={{#chart:Example.Line.chart}} [[commons:Data:Chart Example Data.tab|'''Raw data''']]
|width = 340
|caption = This is an example of a line chart.
}}

{{#chart:Example.Bar.chart}} <center>[[commons:Data:Chart Example Data.tab|'''Raw data''']]</center>

Retrouver les graphiques existants

Les graphiques qui peuvent être utilisés dans les articles sont disponibles sur Wikimedia Commons et peuvent être suivis en utilisant les catégories MediaWiki.

Cette requête peut être utilisée comme proxy pour trouver les graphiques que d'autres ont faits et contribuer aux traductions.

L'ensemble des pages wiki qui utilisent des graphiques sur un wiki particulier peut être trouvé dans la catégorie dont le nom est défini à MediaWiki:chart-render-category et MediaWiki:Chart-error-category (Category:Pages using the Chart extension et Category:Pages using the Chart extension with rendering errors sur ce wiki). Veuillez vous assurer de connecter les catégories de votre wiki à d:Q131382738 et d:Q131406605 pour faciliter la recherche entre les wikis.

Documentation technique

Compte tenu des problèmes liés à Extension:Graph , toutes les décisions concernant la nouvelle extension ont été examinées avec soin, dans l'espoir de renforcer la confiance dans son remplacement.

Jusqu'à présent, les décisions techniques sont documentées dans le référentiel de code du dossier /doc/adr.

Error Monitoring

Failing .chart pages are automatically stored in commons:Category:Pages using the Chart extension with rendering errors. Wiki pages with faulty .charts are automatically stored in [using the Chart extension with rendering errors] in different language versions.

Errors with client side chart rendering will be logged to logstash. (Only for developers.)

Tools for producing the charts

There are several conceivable methods to semi-automatically produce and edit the charts and their tabular data:

• The script graphDataImport can be used in the web browser to extract data from existing graph wikitext and similar, and convert it to a .tab page, a .chart definition page and new wikitext.
• Generative AI can be prompted to extract data from existing graph wikicode and tables, and convert it to .tab and .chart pages and generate new wikicode, according to given specifications. It can also provide translation of titles, and be utilized to extend and update the .tab page with new data.
• The gadget TabularImportExport can convert Excel and .csv files to and from the .tab pages. You can activate it via your Commons preferences.
• The JSON "edit as table" user interface (part of the Jsonconfig extension) is available from the .tab edit page.
• Some bots can periodically import statistics from the web, or from existing Wikipedia graphs, to .tab or .chart pages, upon request. Such bots include DPLA bot and SLiuBot.
• GraphBot ports English Wikipedia graphs to charts.

See also

• Frequently asked questions
• Transforms

Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki.