Manual de extensiones de MediaWiki

Chart Estado de la versión: estableCategory:Stable extensions/es
Implementación	Etiqueta Category:Tag extensions/es
Descripción	Renders charts
Autor(es)	TODO
Política de compatibilidad	La rama maestra mantiene la retrocompatibilidad.
MediaWiki	>= 1.44
Cambios en la base de datos	No
Licencia	Licencia Pública General de GNU 3.0 o posterior
Descargar	Descargar la extensión. Git [?]: Explorar el repositorio (Phabricator · GitHub) revisión de código historial de cambios Download source tarball Category:Extensions in Wikimedia version control/es README
Parámetros $wgChartRequestSizeLimit $wgChartProgressiveEnhancement $wgChartTransformsEnabled $wgChartServiceUrl $wgChartCliPath
Ganchos utilizados LinksUpdateComplete Category:LinksUpdateComplete extensions/es PageSaveComplete Category:PageSaveComplete extensions/es ParserFirstCallInit Category:ParserFirstCallInit extensions/es
Descargas trimestrales	28 (Ranked 68th)
Traduce la extensión Chart si está disponible en translatewiki.net
Incidentes	Tareas abiertas · Reportar un error

Chart es una extensión representadora de gráficos que sustituye a la extensión Graph , y quizás también a la extensión EasyTimeline . La extensión se encuentra en desarrollo para los wikis de Wikimedia en estos momentos. En Extension:Chart/Project hay más detalles sobre el proceso de desarrollo.

Esta extensión admite estos tipos de gráfico:

• Gráfico de líneas
• Gráfico de superficie
• Gráfico de barras
• Gráfico circular

Instalación

Cómo se utiliza

To render a chart, you must define a chart definition to associate with the data source you want to render. A chart definition is structured as a relatively simple JSON file; see Extension:Chart/Specification for the syntax details.

Todos los gráficos en este ejemplo se pueden representar a partir del mismo origen de datos: Data:Chart_Example_Data.tab, un conjunto de datos ficticio. Se puede encontrar el contenido de muestra de estas páginas en el directorio sample.

{
    "license": "CC0-1.0",
    "version": 1,
    "source": "Chart Example Data.tab",
    "type": "line",
    "title": {
        "en": "Example Chart Title"
    },
    "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"
        }
    }
}

Once a chart is defined, you can render it easily using the #chart parser function. In this case, the chart data is defined in Data:Chart_Example_Data.tab, and the chart itself is defined in Data:Example.Line.chart:

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

Personalización

Customization of charts is currently limited. The hope is that, after testing, discussion and evaluation, solutions for customization can be found that do not compromise accessibility, device-specific rendering, or security.

Currently, charts are restricted to a single default color palette. This palette has been carefully designed with accessibility in mind. The thinking behind these color choices can be explored in T369863.

Some charts do require specific color themes, for example, to represent data relating to political parties. It remains an open question of how best to support this type of customization without compromising the ability of readers with accessibility needs (e.g., color blindness) to use them.

Note, while chart's currently render SVG output which can be styled via TemplateStyles, please note that styling associated SVG elements should not be considered stable as it may change at any time. Please do not rely on CSS to alter chart appearance as this may result in non-functional charts in future or may interfere with accessibility features that change font size and features such as dark mode.

The chart format supports defining text like title and labels in different languages, so that the same chart can be used in wikis of different languages. See this example of a chart with support for multiple languages being displayed in a Spanish-language wiki.

This query can be used as a proxy to find charts that others have made and contribute translations.

The set of wiki pages that use charts on any particular wiki can be found in the category whose name is defined at MediaWiki:chart-render-category y MediaWiki:Chart-error-category (Category:Pages using the Chart extension y Category:Pages using the Chart extension with rendering errors on this wiki). Please make sure to connect your wiki categories to d:Q131382738 and d:Q131406605 to make the interwiki search easier.

Error Monitoring

Errors with client side chart rendering will be logged to logstash.

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 wikicode, and convert it to a .tab page, and a .chart definition page.
• 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

Esta extensión está siendo usada en uno o más proyectos de Wikimedia. Esto significa probablemente que la extensión es estable y funciona lo suficientemente bien como para ser usada en sitios con gran cantidad de visitas. Puedes buscar el nombre de esta extensión en los archivos CommonSettings.php e InitialiseSettings.php de Wikimedia para ver dónde se instala. Encontrarás la lista completa de extensiones instaladas en un wiki en particular en la página Special:Version del wiki.