Příručka k rozšířením MediaWiki

Chart Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	Značka Category:Tag extensions/cs
Popis	Renders charts
Autoři	TODO
Zásady kompatibility	Větev master zachovává zpětnou kompatibilitu.
MediaWiki	>= 1.44
Změny v databázi	Ne
Licence	GNU General Public License 3.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs README
Parametry $wgChartRequestSizeLimit $wgChartProgressiveEnhancement $wgChartTransformsEnabled $wgChartServiceUrl $wgChartCliPath
Použité háčky (hooks) LinksUpdateComplete Category:LinksUpdateComplete extensions/cs PageSaveComplete Category:PageSaveComplete extensions/cs ParserFirstCallInit Category:ParserFirstCallInit extensions/cs
Čtvrtletní stahování	29 (Ranked 72nd)
Přeložte rozšíření Chart, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření Chart poskytuje základní interaktivní funkce vizualizace dat, které mají nahradit rozšíření Graph a případně i rozšíření EasyTimeline . Toto rozšíření pro wikiny Wikimedie je v současné době ve vývoji. Další podrobnosti o procesu vývoje naleznete v části Extension:Chart/Project .

Toto rozšíření podporuje následující typy grafů:

• Spojnicový graf
• Plošný graf
• Sloupcový graf
• Výsečový graf

Instalace

Rozšíření Chart vyžaduje nainstalované rozšíření JsonConfig a také stažení knihovny JavaScript (ve skutečnosti TypeScript) Chart Renderer.

Úplné pokyny k nastavení naleznete v souboru README.md v úložišti.

Pro použití v produkčních systémech Wikimedie viz obecné pokyny k nasazení služeb v sekci Wikitech:Kubernetes/Deployments.

Jak používat

Chcete-li vykreslit graf, musíte definovat definici grafu, která bude přiřazena ke zdroji dat, který chcete vykreslit. Definice grafu je strukturována jako relativně jednoduchý soubor JSON. Podrobnosti syntaxe viz Extension:Chart/Specification .

Všechny grafy v tomto příkladu lze vykreslit ze stejného zdroje dat: Data:Chart_Example_Data.tab, fiktivní datová sada. Ukázkový obsah těchto stránek lze nalézt v adresáři 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"
        }
    }
}

Jakmile je graf definován, můžete jej snadno vykreslit pomocí funkce #chart parser. V tomto případě jsou data grafu definována v Data:Chart_Example_Data.tab a samotný graf je definován v Data:Example.Line.chart:

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

Přizpůsobení

Přizpůsobení grafů je v současné době omezené. Doufáme, že po testování, diskusi a vyhodnocení bude možné nalézt řešení pro přizpůsobení, která neohrozí přístupnost, vykreslování specifické pro dané zařízení ani bezpečnost.

Internacionalizace

Grafy lze vkládat pouze do jazyka obsahu wiki. Takže například řetězec dotazu "uselang" (např. ?uselang=es) graf neovlivní.

Formát grafu podporuje definování textu, jako je název a popisky, v různých jazycích, takže stejný graf lze použít na stránkách wikin různých jazyků. Viz příklad grafu s podporou více jazyků zobrazeného na španělsky psané wiki.

Typy grafů

U všech grafů se očekává, že data budou uspořádána do sloupců, přičemž první sloupec bude představovat hodnotu x-axis a následující sloupce budou představovat řady s hodnotou y-axis.

Hledání existujících grafů

Grafy, které lze použít v článcích, jsou k dispozici na Wikimedia Commons a lze je sledovat pomocí kategorií MediaWiki.

Tento dotaz lze použít jako zástupný dotaz k nalezení grafů, které vytvořili jiní, a k jejich překladu.

Sada wiki stránek, které používají grafy na jakékoli konkrétní wiki, se nachází v kategorii, jejíž název je definován na hodnotě MediaWiki:chart-render-category a MediaWiki:Chart-error-category (na této wiki Category:Pages using the Chart extension a Category:Pages using the Chart extension with rendering errors ). Pro snazší vyhledávání na interwiki prosím propojte kategorie wiki s d:Q131382738 a d:Q131406605.

Technická dokumentace

Vzhledem k problémům s Extension:Graph byla všechna rozhodnutí týkající se nového rozšíření pečlivě zvážena s nadějí na vybudování důvěry v jeho nahrazení.

Technická rozhodnutí jsou zatím zdokumentována v repozitáři kódu ve složce doc/adr.

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

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.