Ръководство за МедияУики разширения

Chart Обявен статут: стабиленCategory:Stable extensions/bg
Реализация	Етикет Category:Tag extensions/bg
Описание	Renders charts
Автор(и)	TODO
Правило за съвместимост	Master maintains backward compatibility.
MediaWiki	>= 1.44
Промени в базата данни	Не
Лиценз	GNU General Public License 3.0 or later
Изтегляне	Изтегляне на разширение Git [?]: Browse repository (Phabricator · GitHub) коден преглед Git commit log Download source tarball Category:Extensions in Wikimedia version control/bg README
Параметри $wgChartRequestSizeLimit $wgChartProgressiveEnhancement $wgChartTransformsEnabled $wgChartServiceUrl $wgChartCliPath
Използвани куки LinksUpdateComplete Category:LinksUpdateComplete extensions/bg PageSaveComplete Category:PageSaveComplete extensions/bg ParserFirstCallInit Category:ParserFirstCallInit extensions/bg
Quarterly downloads	27 (Ranked 68th)
Преведете разширението Chart, ако е налично в translatewiki.net
Проблеми	Отворени задачи · Съобщете за грешка

The Chart extension provides basic interactive data visualization capabilities designed to replace the Graph extension, and possibly also the EasyTimeline extension. This extension is currently in development for Wikimedia wikis. See Extension:Chart/Проект for more details on the development process.

This extension supports the following chart types:

• Линейна диаграма
• Площна диаграма
• Колонна диаграма
• Кръгова диаграма

Инсталиране

Инструкции за употреба

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.

All the charts in this example can be rendered from the same data source: Data:Chart_Example_Data.tab, a fictional dataset. Sample contents for these pages can be found in the sample directory.

{
    "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}}

Персонализиране

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.

Интернационализиране

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 и MediaWiki:Chart-error-category (Category:Pages using the Chart extension и 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

This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page.