Extension:TemplateData

This page is a translated version of the page Extension:TemplateData and the translation is 97% complete.

Outdated translations are marked like this.

Other languages:

Deutsch • ‎English • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎lietuvių • ‎português • ‎čeština • ‎русский • ‎українська • ‎अवधी • ‎বাংলা • ‎中文 • ‎日本語

**Základní informace k tomuto rozšíření MediaWiki**
TemplateData Stav rozšíření: stabilní

Zavádění	Tag , API
Popis	Umožňuje ukládat, načítat a vizualizovat informace o šablonách
Napsal(i)	Timo Tijhof, Moriel Schottlender, James Forrester, Trevor Pascal, Bartosz Dziewoński, Marielle Volz, ...
Aktuální verze	0.1.2 (Průběžné aktualizace)
Zásady kompatibility	uvolnění větví
MediaWiki	1.25+
PHP	5.4+
Změny v databázi	nedělá
Licence	GNU General Public License 2.0 nebo pozdější
Zdrojový kód	Download extension Git ^[?]: Download Git master browse repository (GitHub) commit history code review
Parametry $wgTemplateDataUseGUI
Přidané tagy `<templatedata>`
Použité háčky (hooks) EditPage::showEditForm:initial PageContentSave ParserFetchTemplateData ParserFirstCallInit ResourceLoaderRegisterModules
Přeložte rozšíření TemplateData, jsou-li dostupné jeho lokalizační zprávy na webu translatewiki.net
Podívejte se kdo a v jaké verzi toto rozšíření používá.
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření TemplateData zavádí značku <templatedata> a API, které společně umožňují editorům určit, jak mají být šablony vyvolány. Tato informace je k dispozici jako formátovaná tabulka pro koncové uživatele a jako JSON API, které umožňuje jiným systémům (např. VisualEditor) vytvářet rozhraní pro práci se šablonami a jejich parametry. Podrobnou nápovědu najdete v Nápověda:TemplateData .

Instalace

Stáhněte soubor/y a vložte do adresáře pojmenovaného TemplateData ve vaší složce extensions/.

Na konec vašeho souboru LocalSettings.php přidejte řádek s následujícím kódem:
```
wfLoadExtension( 'TemplateData' );
```
Hotovo – Přejděte na stránku Special:Version vaší wiki, a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Pro ty co používají MediaWiki 1.24 a starší:

Výše uvedené instrukce se týkají instalace přes wfLoadExtension(), což je novější způsob instalace rozšíření. Pokud potřebujete toto rozšíření nainstalovat na starší verzi (MediaWiki 1.24 či starší), musíte místo wfLoadExtension( 'TemplateData' ); použít:

require_once "$IP/extensions/TemplateData/TemplateData.php";

Úpravy dat

Rozšíření TemplateData funguje tak, že ve wikitextu šablony stránky je definována značka <templatedata> (volitelně může být také přenesena z jiné stránky). Toto je navrženo tak, aby bylo kompatibilní s běžným rozvržením, které má mnoho wiki při předávání dokumentace k šablonám ze samostatné stránky (není to však nutné). Tento obsah značky <templatedata> musí být platný JSON ve formátu popsaném níže. Všimněte si, že všechny popisy musí být ve formátu prostého textu (v datech šablony není akceptován žádný wikitext).

Je-li na stránce zahrnut blok <templatedata>, provede rozšíření TemplateData při ukládání stránky následující kontroly:

Obsah musí být platný JSON;
Každá položka ve struktuře JSON musí být očekávaného typu, jak je uvedeno níže (např. Objekt, pole nebo primitiv); a
U položek, které mají specifikovaný seznam možných hodnot (např. params.yourParameterName.type), musí hodnota v objektu JSON odpovídat jedné z těchto hodnot.

Pokud některá z těchto kontrol selže, server nebude moci ukládat a nad editační stránkou se zobrazí chybová zpráva.

U položek s automatickým přidáním bug 2700 zabraňuje práci subst: v jakékoli šabloně přidané uvnitř <tag>, včetně tagů <ref> a <gallery>. Blok TemplateData se uloží správně, ale výsledný wikitext nebude při použití šablony správně analyzován.

Všimněte si, že nemůžete použít {{#tag:templatedata}} místo <templatedata>.

Formát

Níže je vizualizovaná verze dat JSON, jak je definována na stránce šablony uzavřené značkami <templatedata></templatedata>. Formální specifikace je k dispozici v repozitáři TemplateData. Nejnovější verzi najdete na Specification.md.

Objekt TemplateData

Objekt TemplateData je kořenový prvek JSON uzavřený v prvku <templatedata> na stránce šablony.

Klíč	Typ	Popis
`description`	nebo $nul	Stručný popis šablony. Musí to být prostý text. Po vyplnění může být zobrazen jako titulek při úpravě jedné šablony a možná ve výsledcích vyhledávání, když si uživatelé vyberou jednu z mnoha. Výchozí hodnota je $null.
`params`	Objekt obsahující Param objects	Objekt, který mapuje každý název parametru šablony na odpovídající Param object popisující vlastnosti tohoto parametru.
`paramOrder`	Pole obsahující řetězce názvů parametrů	Logické pořadí, ve kterém by se měly parametry zobrazovat. Pole obsahuje každý klíč parametru přesně jednou. Každý řetězec musí být platným klíčem v objektu `params`. Pokud tento klíč neexistuje ve struktuře `<templatedata></templatedata>` na stránce šablony, přidá se do struktury poskytované API pomocí pořadí, ve kterém se parametry vyskytují v objektu TemplateData.
`sets`	Pole obsahující Nastavení objektů	Pole obsahující specifikace sady. Sada je skupina parametrů, které by měly být použity společně. Výchozí nastavení je []. Všimněte si, že funkce `sets` je stále ve vývoji.
`format`	řetězec, buď `inline` nebo `block`	Jak by mělo být uspořádáno zobrazení wikitextu šablony. Výchozí nastavení je `inline`. Další vlastní formáty viz #Custom_formats.
`maps`	Mapový objekt	Objekt, který mapuje zjednodušené jméno spotřebitele třetí strany dat šablony (tj. Citoid, Special:MyLanguage/Wikidata atd.), Na objekt, který zase mapuje jméno parametru spotřebitele na jeden nebo více odpovídajících názvů parametrů šablony.

Param objekt

Klíč Typ Výchozí Popis

label InterfaceText null (Velmi) krátký název parametru. Zkuste zachovat méně než 20 znaků.

description InterfaceText null Stručný popis parametru, aby uživatelé věděli, které mají vybrat ze seznamu možností.

required boolean false Parametr je vyžadován pro to, aby šablona fungovala (true, pokud musí být zadán tento parametr).

suggested boolean false Parametr je navržen pro šablonu, aby byla užitečná (true, pokud měl by být tento parametr uveden).

deprecated booleovský nebo řetězec false Parametr je zastaralý. Hodnota může být řetězec instrukcí poskytujících uživateli návod, co místo toho lze udělat, nebo může být jednoduše true.

aliases Řetězce obsahující pole [] Seznam přezdívek (aliases). Alias je alternativní název parametru, který lze použít namísto (nikoli vedle) primárního názvu. Aliasy nejsou dokumentovány v samostatném objektu Parameter. Pokud potřebují více informací, měly by být ve svém vlastním majetku označeny jako "deprecated" (zastaralé).

default InterfaceText null Výchozí hodnota použitá šablonou, není-li parametru nebo jeho popisu přiřazena žádná hodnota.

autovalue řetězec null Dynamicky generovaná výchozí hodnota ve wikitextu, jako je dnešní datum nebo jméno editujícího uživatele. Bude často zahrnovat náhradu wikitextu, jako je {{subst:CURRENTYEAR}}.

example InterfaceText null Příklad textu parametru, který uživatelům pomůže vyplnit správnou hodnotu.

type

řetězec

"unknown"

Typ parametru pro (soft) typ hinting. Jeden z:

Řetězcová hodnota	Typ parametru
"unknown"	Předpokládaný typ, pokud není nastaven
"number"	Jakákoli číselná hodnota (bez desetinných míst nebo oddělovačů tisíců)
"string"	Jakákoli textová hodnota. Může obsahovat konce řádků.
"line"	Krátké textové pole - používá se pro jména, štítky a jiná pole krátkých formulářů. Předpokládá se, že se jedná o text, u kterého se neočekává, že bude obsahovat konce řádků.
"boolean"	Booleovská hodnota ('1' pro true, '0' pro false, '' pro neznámé), viz Tříhodnotová logika.
"date"	Datum ve formátu ISO 8601, např. "2014-05-09" nebo "2014-05-09T16:01:12Z"
"url"	URL, včetně protokolu, např. "http://www.example.org", "https://example.org", nebo "//example.org".
"wiki-page-name"	Platný název stránky MediaWiki pro aktuální wiki. Nemusí existovat, ale pokud ano, měl by být platný název stránky, který by mohl být vytvořen.
"wiki-file-name"	Platný název souboru MediaWiki pro aktuální wiki. Nemusí existovat, ale pokud ano, měl by být platný název souboru, který lze nahrát. Neměla by obsahovat jmenný prostor (např. "Foo.svg" ne "File:Foo.svg" nebo "Bild:Foo.svg").
"wiki-template-name"	Platný název šablony MediaWiki pro aktuální wiki.
"wiki-user-name"	Platné uživatelské jméno MediaWiki pro aktuální wiki. Nemusí existovat, ale pokud ano, mělo by to být platné uživatelské jméno, které by bylo možné vytvořit. Neměla by obsahovat jmenný prostor (např. "Foo", nikoli "User:Foo" nebo "Usario:Foo").
"content"	Obsah stránky ve wikitextu, například styl textu, odkazy, obrázky, atd.
"unbalanced-wikitext"	Surový wikitext, který by neměl být považován za samostatný obsah, protože je nevyvážený - například šablony spojující neúplný wikitext jako větší celek, například `{{echo\|before=<u>\|after=</u>}}`

inherits řetězec žádný
nahrazený Klíč názvu jiného parametru (musí to být platný klíč v objektu params). Aktuální parametrový objekt zdědí vlastnosti od zadaného objektu parametrů, přičemž místní vlastnosti potlačí zděděné.

Nastavení objektu

Klíč Typ Výchozí Popis

—

Pole polí

[]

Typ parametru pro (soft) typ hinting. Jeden z:

Nastavení objektu
Klíč	Objekt nebo primitivní typ	Popis
`label`	InterfaceText	(Velmi) krátký název sady parametrů. Zkuste zachovat méně než 20 znaků.
`params`	Pole řetězců	Jeden nebo více názvů parametrů, které mají být v sadě zahrnuty (každý musí být platným klíčem v objektu `params`). Parametr může být ve více sadách. Ne každý parametr musí být v sadě.

Mapový objekt

Klíč	Typ	Výchozí	Popis
jméno spotřebitele	objekt	{}	Objekt, který mapuje jméno spotřebitele na objekt, který zase mapuje jméno parametru spotřebitele na jeden nebo více odpovídajících parametrů parametrů šablony. Názvy parametrů šablon mohou být zadány buď jako řetězec (jedno jméno), pole řetězců (několik jmen) nebo pole polí řetězců (několik sad názvů). Každý z těchto řetězců musí být platným klíčem v objektu `params` jinde v TemplateData stejné šablony. Specifický parametr šablony může být ve více mapách a může být použit v hodnotách více klíčů v dané mapě, ale ne každý parametr šablony musí být v mapě. Stručný příklad z Template:Cite_news#TemplateData anglické Wikipedia ilustruje strukturu objektu map. { "proveit": { "main": "title", "textarea": [ "quote" ] }, "citoid": { "title": "title", "url": "url", "publisher": "publisher", "publicationTitle": "work", "date": "date", "ISSN": [ "issn" ], "ISBN": [ "isbn" ], "contributor": "others", "author": [ [ "first", "last" ], [ "first2", "last2" ], [ "first9", "last9" ] ], "editor": [ [ "editor-first", "editor-last" ] ] } }

Text rozhraní (řetězec nebo objekt)

Volný textový řetězec prostého textu (tj. Žádný wikitext nebo HTML) v jazyce obsahu wiki nebo objekt obsahující tyto řetězce klíčované kódem jazyka.

Výchozí hodnota pro všechna textová pole rozhraní je $null.

Typ řetězce

Pokud se jedná o řetězec, musí obsahovat nealokalizovaný řetězec v jazyce obsahu místní wiki.

Typ objektu

Pokud se jedná o objekt, musí mít toto mapování:

Klíč	Typ	Popis
Kód jazyka Wikipedia	řetězec	Lokalizovaný řetězec pro použití na Wikipedii odpovídající danému kódu jazyka.

Příklad mapování objektu:

Klíč	Hodnota
"en"	"Welcome to Wikipedia"
"de"	"Willkommen bei Wikipedia"
"fe"	"Bienvenue sur Wikipédia"
"nl"	"Welkom op Wikipedia"
"it"	"Benvenuti su Wikipedia"
"es"	"Bienvenidos a Wikipedia"
"ru"	"Добро пожаловать в Википедию"

Příklad

Příklad struktury TemplateData, jak je uvedeno ve wikitextu na stránce šablony.

<templatedata>
{
    "description": "Label unsigned comments in a conversation.",
    "params": {
        "user": {
            "label": "User's name",
            "type": "wiki-user-name",
            "required": true,
            "description": "User name of person who forgot to sign their comment.",
            "aliases": ["1"]
        },
        "date": {
            "label": "Date",
            "suggested": true,
            "description": {
                "en": "Timestamp of when the comment was posted, in YYYY-MM-DD format."
            },
            "aliases": ["2"],
            "autovalue": "{{subst:#time:Y-m-d}}"
        },
        "year": {
            "label": "Year",
            "type": "number"
        },
        "month": {
            "label": "Month",
            "inherits": "year"
        },
        "day": {
            "label": "Day",
            "inherits": "year"
        },
        "comment": {
            "required": false
        }
    },
    "sets": [
        {
            "label": "Date",
            "params": ["year", "month", "day"]
        }
    ],
    "maps": {
        "ExampleConsumer": {
            "foo": "user",
            "bar": ["year", "month", "day"],
            "quux": [
                "date",
                ["day", "month"],
                ["month", "year"],
                "year"
            ]
        }
    }
}
</templatedata>

Níže je uveden příklad, který by se zobrazil na stránce šablony:

Label unsigned comments in a conversation.

Template parameters
Parameter		Description	Type	Status
User's name	`user` `1`	User name of person who forgot to sign their comment.	User	required
Date	`date` `2`	Timestamp of when the comment was posted, in YYYY-MM-DD format. Auto value `{{subst:#time:Y-m-d}}`	Unknown	suggested
Year	`year`	no description	Number	optional
Month	`month`	no description	Number	optional
Day	`day`	no description	Number	optional
Comment	`comment`	no description	Unknown	optional

API

Podívejte se na vygenerovanou nápovědu na Special:ApiHelp/templatedata. Ukázka vyvolání (formátovaná pro čitelnost lidmi) je:

api.php?action=templatedata&titles=Template:Cite%20web&format=jsonfm [try in ApiSandbox]

Tím se vrátí data šablony pro Šablona:Citovat web. Blok <templatedata>...</templatedata> pro tuto šablonu je na stránce s dokumentací o přenesené šabloně, en:Template:Cite web/doc.

Přírůstky a změny JSON přijaté z API

Struktura JSON poskytovaná v reakci na požadavek API HTTP get se výrazně liší od struktury definované v bloku <templatedata>...</templatedata>. V reakci na požadavek API provede rozšíření TemplateData následující změny objektu JSON:

Přidá dvě obtékání objektů:
1. Celkově objekty stránek obsahující jeden nebo více objektů stránek
2. Objekt s numerickým klíčem: stránka objektu
Přídavky nebo změny skutečného TemplateData objektu
1. Přidejte klíč názvu title s názvem stránky, ze které byla požadována data (např. "Template:Cite web").
2. Přidejte klíč a pole paramOrder v pořadí, ve kterém se parametry vyskytují v klíči params v rámci TemplateData objektu na stránce šablony.
3. Přidejte klíč sets
4. Změňte všechny výskyty TemplateText, které jsou pouhými řetězci, na objekty s jediným klíčem pro aktuální kód jazyka Wikipedia
5. Odstraňte všechny klíče inherits.
  - Přidejte všechny vlastnosti z parametru, ze kterého je definována dědičnost a které nejsou nahrazeny explicitně definovanými klíči v Parameter Object dědicem.
6. Přidejte výchozí hodnoty pro všechny klíče v každém Parameter Object, které nebyly explicitně definovány nebo zděděny.

Vizualizované rozdíly v objektu JSON TemplateData dodané API

JSON Root
Klíč	Typ	Popis
`pages`	Page Object	Page object (obsahuje jeden klíč, kterým je číslo stránky). Pokud bylo požadováno více stránek najednou, bude existovat více Page objektů.

Objekt stránky
Klíč	Typ	Popis
(číslo stránky)	TemplateData Object	TemplateData Object obsahující užitečné informace. Klíč je statické číslo stránky pro stránku šablony, ze které byla požadována data JSON.

Objekt TemplateData (přidáno pomocí API)
Následující klíč je přidán do kořene objektu JSON, který je uzavřen ve značkách `<templatedata>` na stránce šablony.
Klíč	Typ	Popis
`title`	řetězec	Název stránky šablony (např. "Template:Cite web"). Tento klíč není součástí struktury JSON na stránce šablony. Je přidán do struktury pomocí softwaru MediaWiki na cestě k doručení přes API.
`paramOrder`	Pole obsahující řetězce názvů parametrů	Logické pořadí, ve kterém by se měly parametry zobrazovat. Pole obsahuje každý klíč parametru přesně jednou. Každý řetězec musí být platným klíčem v objektu `params`. Pokud neexistuje ve struktuře `<templatedata></templatedata>` na stránce šablony, přidá se do struktury podle rozhraní API pomocí pořadí, ve kterém se parametry vyskytují v objektu TemplateData.
`sets`	Pole obsahující nastavení objektů	Pole obsahující specifikace sady. Sada je skupina parametrů, které by měly být použity společně. Pokud na stránce šablony neexistuje, přidá se jako struktura do rozhraní poskytovaného API jako prázdné pole.

Objekty parametrů z API
Klíč	Typ	Popis
`label`	InterfaceText	Přeloženo do InterfaceText objektu, pokud již není v tomto formátu.
`required`	boolean	Pokud není definován, přidá se výchozí hodnota false.
`description`	InterfaceText nebo `null`	Pokud je definován jako řetězec, převeden na InterfaceText objekt. Pokud není definován, přidává se klíč s hodnotou $null.
`deprecated`	booleovský nebo řetězec	Pokud není definován, přidá se výchozí hodnota false.
`aliases`	Pole řetězců	Pokud není definován, je přiřazeno výchozí prázdné pole (tj. []).
`default`	řetězec	Pokud není definován, je přiřazena výchozí hodnota "".
`type`	řetězec	Pokud není definován, je přiřazena výchozí hodnota "unknown".
`inherits`	(odstraněno)	Tento klíč je odstraněn a jsou přidány všechny zděděné klíče. Klíče definované pro aktuální parametr mají přednost a všem klíčům, které nejsou definovány ani na aktuálním parametru, ani na klíči, od kterého zdědí, je dána výchozí hodnota.

Text rozhraní (Object nebo $null):
Objekt obsahující řetězce klíčované kódem jazyka.
Klíč	Objekt nebo primitivní typ	Popis
Object (obsahující lokalizované řetězce podle kódu jazyka Wikipedia) Pokud pole TemplateData na stránce šablony obsahuje řetězec, nikoli objekt s lokalizovanými řetězci, MediaWiki jej převede do objektu InterfaceText s řetězcem přiřazeným názvu klíče zdroje Wikipedia Kód jazyka Wikipedia. Výchozí hodnota pro všechna pole $itft je $nul.
(Kód jazyka Wiki)	řetězec	Lokalizovaný řetězec pro použití na Wikipedia odpovídající Kódu jazyka Wikipedia.

Příklad objektu JSON poskytovaného API

Odpověď na žádost API o strukturu TemplateData v části Příklad (výše) lze vidět:

Ve formátu HTML: https://www.mediawiki.org/w/api.php?action=templatedata&titles=Extension:TemplateData&format=jsonfm
Podle rozhraní API: https://www.mediawiki.org/w/api.php?action=templatedata&titles=Extension:TemplateData

Konfigurace

Proměnná	Výchozí	Popis
`$wgTemplateDataUseGUI`	`true`	Experimentální dialogové rozhraní pro úpravu templatedata JSON

Související odkazy

Extension:TemplateWizard – uživatelské rozhraní pro výběr a vložení wikitextu šablon, na základě jejich $dat.
GitHub: jeblad/TemplateData – alternativní verze s některými funkcemi Lua.

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.