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 $wgChartCliPath $wgChartServiceUrl $wgChartProgressiveEnhancement
Použité háčky (hooks) LinksUpdateComplete Category:LinksUpdateComplete extensions/cs PageSaveComplete Category:PageSaveComplete extensions/cs ParserFirstCallInit Category:ParserFirstCallInit extensions/cs
Čtvrtletní stahování	36 (Ranked 74th)
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.

Jak používat

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.

Chcete-li vykreslit graf, musíte definovat definici grafu, která bude přiřazena ke zdroji dat, který chcete vykreslit. Definice grafu je relativně jednoduchý soubor JSON. V definici grafu zadejte následující:

• license – licence, pod kterou je graf k dispozici
• version – použitá verze schématu grafu (aktuálně je k dispozici pouze verze 1)
• type – typ vykreslovaného grafu. Aktuálně jsou podporovány: line, area, bar, pie
• source – kde získat data pro graf. (v současné době lze jako zdrojová data použít pouze sady Tabulární data )
• xAxis -> title – čím označit osu x
• xAxis -> format – none nebo auto (default, auto has compact notation like 2K for 2000 and thousands separators)
• yAxis -> title – čím označit osu y
• yAxis -> format – viz výše
• mediawikiCategories – seznam kategorií MediaWiki pro sledování tohoto grafu

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

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ů

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 aMediaWiki:Chart-error-category (na této wiki Category:Pages using the Chart extension aCategory: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í.

So far, the technical decisions are documented in the code repository in the doc/adr folder.

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.