Nápověda:Strojový popis šablony
![]() |
Poznámka: Editací této stránky souhlasíte s uvolněním svého příspěvku pod licencí CC0. Více informací se dočtete na stránce Public Domain Help Pages.
|
![]() |
TemplateData je rozšíření, které ukládá informace a parametry spojené s šablonou wikitextu a zpřístupňuje je editačnímu rozhraní, které je může načíst a prezentovat v editoru šablon – to vše pomáhá uživatelům přidávat a upravovat šablony na stránky.
Od dubna 2019 je funkce TemplateData součástí výchozího uživatelského prostředí pro všechny uživatele na všech wiki Wikimedie, pokud přidávají šablonu, včetně neregistrovaných uživatelů. Jak výchozí zdrojové, tak vizuální editory jej určitým způsobem zahrnují, stejně jako mnoho skriptů, nástrojů a gadgetů. Pokud máte vlastní wiki, budete muset nainstalovat Extension:TemplateData .
Přidání TemplateData do šablony pro použití tohoto rozšíření v podstatě spočívá ve vložení malého, jednoduchého bloku kódu JSON (vysvětleno níže) na stránku dokumentace šablony. Můžete to udělat ručně nebo pomocí editoru TemplateData, grafického uživatelského rozhraní, ke kterému máte přístup na stránkách šablony "Editovat"/"Editovat zdroj" na wiki s nainstalovaným rozšířením TemplateData. JSON obsahuje seznam parametrů šablony a informace o těchto parametrech a o šabloně jako celku (podrobnosti viz níže).
Šablony, které obsahují TemplateData, zobrazí tyto informace v uživatelském rozhraní, pokud uživatel přidá šablonu. V některých případech se změní chování editoru, když jej použijete k úpravě nebo vložení dané šablony. Což uživatelům výrazně usnadní provádění kroků potřebných k přidání dané šablony.
Historie
TemplateData byl původně vyvinut na začátku roku 2013 s ohledem na VisualEditor , což bylo v té době ve fázi testování MediaWiki. VisualEditor je hlavní vizuální editační rozhraní pro wiki Wikimedie a TemplateData mu umožnilo mít užitečnější rozhraní při přidávání šablon. To bylo okamžitě oficiálně podporováno VisualEditorem. Vzhledem k tomu, že VisualEditor byl rozšířen na různé hlavní wiki Wikimedie jako výchozí funkce od roku 2013 do roku 2016. TemplateData se také stala jejich součástí.
V prosinci 2016 bylo rozhraní VisualEditor zpřístupněno pro úpravy zdrojového kódu jako funkce beta. Bylo nazýváno Editor wikitextu 2017 . To poprvé přineslo funkce TemplateData do úpravy zdroje.
V březnu 2018 společnost Sam Wilson vyvinula rozšíření TemplateWizard , rozšíření editoru GUI pro výchozí zdrojový editor Wikimedia, WikiEditor (jinak známý jako editor wikitext 2010), jehož cílem je usnadnit proces přidávání šablon pomocí informací z TemplateData. V dubnu 2019 byl TemplateWizard nastaven jako výchozí součást editoru wikitext 2010 na všech wiki Wikimedie. To znamenalo, že TemplateData se stala výchozí součástí vizuálního editoru i zdrojového editoru na wiki Wikimedie.
Přidání nebo úprava TemplateData
Chcete-li přidat nebo upravit TemplateData, nejprve přejděte na stránku šablony, která se nachází v "/Template:Templatename".
Kontrola aktuálního stavu
Před přidáním nebo úpravou TemplateData zkontrolujte, zda má šablona podstránku dokumentace. Poté zkontrolujte, zda šablona již obsahuje TemplateData a pokud ano, zda se nachází na stránce šablony nebo na podstránce dokumentace.
Dokumentace podstránek
Existují dva hlavní způsoby, jak šablony na většině wiki Wikimedie ukládají své poznámky k použití a další data, která by neměla být zahrnuta do samotné šablony, jako jsou kategorie, ve kterých by šablona měla být obsažena:
- Velká většina šablon uchovává poznámky k použití a další data, která nepatří na samotnou stránku šablony, na podstránce dokumentace: "/Template:Templatename/doc". Na stránkách, jako je tato, šablona {{Documentation}} přenese veškerý obsah stránky /doc na stránku šablony, přičemž zdrojový kód šablony bude mnohem čistší.
- Několik stránek šablony si zachovalo tyto informace na hlavní stránce šablony. Na těchto stránkách to můžete najít tak, že mezi značkami
<noinclude>
vyhledáte výskyt{{Documentation|content=
.
Různé wiki mohou toto vše prezentovat různě.
Zřídkakdy mohou hlavní stránky šablon trvale obsahovat dokumentaci, i když jste zkontrolovali vše výše uvedené.
Zde uživatel přidá vlastní název stránky /doc mezi "{{Documentation|
" a "|content=
" a poté přidá obsah za "|content=
".
You can also look for a notice at the bottom of the page similar to this: "The above documentation is transcluded from Template:Templatename/doc".
Templates without documentation subpages
If a template doesn't have a documentation subpage, create it and move the template's documentation there (or a placeholder for it). Then you can add TemplateData to the documentation subpage.
Creating the subpage and moving the documentation
To create the documentation subpage, click "Editovat"/"Editovat zdroj" on the main template page; look for the <noinclude>
tags and their contents (usually at the bottom).
It should look something like this:
<noinclude>
{{Documentation|content=
== Usage ==
Information about usage.
== More example headings ==
More example contents
[[Category:Example category]]
[[Category:Example category 2]]
}}
</noinclude>
You may also find that it already contains TemplateData. If so, it will look something like this:
<noinclude>
{{Documentation|content=
...
<templatedata>
{
"description": "",
"params": {
"1": {
"label": "Example parameter",
"description": "Example parameter description",
"type": "string"
}
}
}
</templatedata>
</noinclude>
Select everything after "|content=
" and before "</noinclude>
" and cut it into your clipboard or save it in a temporary document. Delete "|content=
", leaving only the following:
<noinclude>
{{Documentation}}
</noinclude>
Save the template page.
Now, to create the new subpage, look at your browser's address bar and add /doc to the end of the URL. Press ↵ Enter, then choose the option to create a new page.
If this wiki has a {{Documentation subpage}} notice template, add it at the top of the new page. You may also wish to add other templates, such as a {{Purge button}} or {{Purge}} link (if supported by the wiki in question). See m:Help:Template documentation for more info.
Insert the text you cut or saved in the previous text (beneath the notice template, if applicable).
Wrap any categories in <includeonly>
tags so that they apply only to the template's main page:
<includeonly>
[[Category:Example category]]
[[Category:Example category 2]]
</includeonly>
Many wikis have a {{Sandbox other}}
template.
Use this template here if it's likely that the template you're editing exists in a sandbox version (located at "Template:Templatename/sandbox") in order to prevent the categories from applying to the sandbox page:
<includeonly>{{sandbox other||
[[Category:Example category]]
[[Category:Example category 2]]
}}</includeonly>
Finally, publish the page.
You can now add and edit the TemplateData on the documentation subpage using the instructions described in #Methods.
Adding and editing TemplateData on the main template page
If you can't create the /doc page, you can add and edit TemplateData on the template's main page by following the instructions in #Methods.
If a template has a documentation subpage, check both the main page and the documentation subpage for the presence of TemplateData (the <templatedata>
tag followed by an array inside curly brackets: {}
).
Alternatively, the TemplateData extension can perform this check for you. Click "Editovat" or "Editovat zdroj" on either page. If the template already has TemplateData on either page, you will see a yellow notice at the top of the page saying either:
- Upozornění: Blok Strojového popisu šablony je již uveden na související stránce „[[Template:Templatename/doc]]“.
or
- Upozornění: Blok Strojového popisu šablony je již uveden na související stránce „[[Template:Templatename]]“.
If the template has TemplateData on its documentation subpage
If the template has TemplateData on its documentation subpage, this is the page you should edit.
You can do this by clicking the "[edit]" located after the heading " Template documentation" (or similar), or, if you are already on the /doc page, by clicking "Editovat" or "Editovat zdroj" at the top.
Follow the guidance at #Methods to add or edit the TemplateData.
If the template has TemplateData on its main page
If the template has TemplateData on its main page, you once again have two options:
- You can either move to its documentation subpage. This is the preferred option.
- Or, you can edit it on the main template page.
Moving TemplateData to the documentation subpage
To do this, click "Editovat"/"Editovat zdroj" on the main template page, and look for the <templatedata>
tags, enclosed within <noinclude>
tags.
It should look something like this:
<noinclude>
{{Documentation}}
<templatedata>
{
"description": "",
"params": {
"1": {
"label": "Example parameter",
"description": "Example parameter description",
"type": "string"
}
}
}
</templatedata>
</noinclude>
Cut only the <templatedata>
tags and their contents out of the code, then save the page.
Next, edit the documentation subpage by clicking the "[edit]" located after the heading " Template documentation" (or similar).
Type a heading, like "TemplateData", then beneath it paste the TemplateData.
You can now edit the TemplateData based on the guidance at #Methods.
Editing TemplateData on the main template page
If you do not wish to move the TemplateData to the /doc page, you can edit it on the main template page. See #Methods for how to edit TemplateData.
If the template does not yet have TemplateData but has a doc subpage
If the template does not yet have TemplateData, you should add it to the documentation subpage.
Do this by clicking the "[edit]" located after the heading " Template documentation" (or similar), or, if you are already on the /doc page, by clicking "Editovat" or "Editovat zdroj" at the top.
Type a heading, like "TemplateData", then add it beneath this heading.
The section #Methods explains how to add TemplateData.
Methods
Metoda editoru TemplateData
This is a simple way to add or edit TemplateData, recommended for less experienced users.
Editor TemplateData je grafické uživatelské rozhraní pro přidávání a úpravy TemplateData. It is part of the TemplateData extension, available on any template's page (or documentation subpage) by clicking "Editovat" or "Editovat zdroj".
After clicking "Editovat" or "Editovat zdroj", you will see a button above the editing area and page title that says "Spravovat Strojový popis šablony".
Kliknutím na toto tlačítko vstoupíte do editoru TemplateData. Pokud stránka, na které jste, již obsahuje TemplateData, automaticky se zde zobrazí.
Features in the above window:
- The top item chooses the language of the interface text. It allows you to enter text content in multiple languages, displayed to users based on their settings in Preferences, not based on the wiki's language; different wikis have entirely different template databases. If no language TemplateData exists, the interface will only offer users the wiki's own language, but users can click "Přidat jazyk" to add more inputs. The language code is displayed in brackets next to the parameters to which it can be applied, such as descriptions and labels.
- The next item is the template description. This is the description of the template as a whole; it's shown to users in numerous places in the template editors while adding a template. This parameter and its effects are outlined here.
- The third item controls the wikitext formatting of the template. This parameter determines how the wikitext will be laid out when the user clicks "Použít", the two main types being
"inline"
(on one line) and"block"
(on new lines). This parameter and its effects are outlined here.
- If the user chooses "Vlastní", they can enter wikitext under "Vlastní formátovací řetězec" according to rules outlined here, in order to create a custom layout for the template when the user clicks "Použít".
- The fourth item configures a template's parameters. If parameters have already been defined in TemplateData, this area displays them in a list. If the template's source code specifies parameters for which no TemplateData exists, you may see a button labeled "Přidat 2 navržené parametry". The editor extracts these suggestions from the template's source code by looking for
{{{parametername}}}
or{{{parametername|}}}
. Clicking "Přidat 2 navržené parametry" will add these parameters using their names as defined in the source code. A green notice will also appear at the top, for example, "Byly naimportovány 2 nové parametry: names of parameters".
- At the bottom of the window you see an "Přidat parametr" button. This allows you to add a parameter manually with a custom name.
Continue to the next step by clicking any one of the parameters in the list. This will allow you to edit that parameter's info.
All of these features and their effects are outlined in the section #Within a parameter's name.
- The TemplateData editor will not allow you to change a parameter to a blank "Název". Parameters in TemplateData that somehow acquire blank strings as names will not cause issues in the 2010 wikitext editor with TemplateWizard, but neither VisualEditor nor the 2017 wikitext editor will display them at all. This is the only mandatory field in the TemplateData editor.
- Clicking "Odstranit informace o parametru" will delete the parameter and all its information from the TemplateData. You can't retrieve or undo this in the TemplateData unless you click "X" afterwards. You can undo any changes made after clicking "Použít" by hitting Ctrl+Z.
- Exiting the TemplateData editor after making changes prompts you to confirm that you want to discard your changes.
When finished, click "Odstranit informace o parametru".
This will automatically insert the TemplateData at the bottom of the page before the </noinclude>
tag; or, if already present, it will be updated with the new information without changing its position.
The TemplateData text will also be selected when you click "Odstranit informace o parametru".
The TemplateData editor creates a "paramOrder"
parameter at the bottom of the TemplateData (or updates it if it already exists).
"paramOrder"
contains the current TemplateData parameters in the order in which they were displayed by the TemplateData editor.
You can change the "paramOrder"
by dragging the parameters up and down in the TemplateData editor using the three horizontal bars on the left.
"paramOrder"
and its effects are described here.
After this, click "Uložit" to save your revision of the page.
Manual method
You can also add or edit TemplateData manually.
Struktura TemplateData je založena na standardu JSON, ale nemusíte se učit JSON, abyste se naučili, jak umístit TemplateData.
TemplateData follows a few very simple rules and accepts only a few dozen possible predefined parameters and values, typically following a "parameter": "value"
format.
Adding TemplateData manually
Considerations:
- If you're adding TemplateData on a template's documentation subpage (recommended), you may add it anywhere on the page; check to see if your language's Wikipedia has a preferred location for it. For example, on the English Wikipedia, TemplateData is typically near the bottom of the documentation page; on the German Wikipedia, it is typically at the top.
- If you're adding TemplateData on a template's main page (not recommended; see #Prior checks), you must make sure to place it inside the
<noinclude>...</noinclude>
tags.
Click "Editovat" or "Editovat zdroj" on the respective page, then move to the place in the page where you intend to add TemplateData and write a heading: "TemplateData".
Many wikis have a {{TemplateData header}} template that adds a short notice regarding TemplateData. If your wiki does, add it after the heading.
To start adding TemplateData, type an opening and closing <templatedata>
tag and a pair of curly brackets on new lines, with an empty line between them:
<templatedata>
{
}
</templatedata>
Next, add an indent on the empty line between the two curly brackets, and start adding parameters. Details for the parameters can be found at #TemplateData parameters. Most are optional; some are highly recommended.
Parameters can be in any order, but what follows is the order that best conforms to TemplateData documentation and makes the content easiest to use for editors:
<templatedata>
{
"description": "",
"format": "",
"params": {
"parameter1": {
"aliases": ["",""]
"label": "",
"description": "",
"type": ""
}
},
"paramOrder": [
""
]
}
</templatedata>
Ujistěte se, že parametry, například v objektu "params"
, zůstávají uvnitř tohoto objektu. Jinak při pokusu o uložení spustíte chybu "Neočekávaná vlastnost „správně pojmenovat“.(properlyname)".
Příklad
Here is some example TemplateData for a hypothetical cleanup template. Such a template would display a notice and place the page into a dated category based on the month and year entered. The notice might also contain a link to a talk page section. The TemplateData would look something like this:
<templatedata>
{
"description": "Use this template to indicate that an article is in need of cleanup.",
"format": "inline",
"params": {
"date": {
"label": "Month and year",
"description": "The month and year that the template was added",
"type": "string",
"autovalue": "{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}",
"example": "January 2013",
"suggested": true
},
"reason": {
"aliases": ["1"],
"label": "Reason",
"description": "The reason the article is in need of cleanup",
"type": "string"
},
"talk": {
"aliases": ["talksection"],
"label": "Talk page section",
"description": "The section of the talk page containing relevant discussion",
"type": "string"
}
},
"paramOrder": [
"date",
"reason",
"talk"
]
}
</templatedata>
The corresponding TemplateData documentation would display as follows:
Use this template to indicate that an article is in need of cleanup.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Month and year | date | The month and year that the template was added
| String | suggested |
Reason | reason 1 | The reason the article is in need of cleanup | String | optional |
Talk page section | talk talksection | The section of the talk page containing relevant discussion | String | optional |
TemplateData parametry
Všechny dostupné parametry TemplateData jsou uvedeny níže s popisem a s příkladem. Jsou také podrobněji uvedeny na Extension:TemplateData#Format.
- Tyto informace jsou aktuální od listopadu 2021 a mohou se změnit, pokud jsou přidány nové parametry nebo rozhraní pro úpravy šablon získají aktualizace, které podporují stávající parametry nebo zacházejí s určitými parametry odlišně.
- Wiki označení nebude fungovat v popisech ani na štítcích. Je to striktně textový řetězec.
- New lines ("
\n
") in descriptions, labels, examples or defaults will not show in any of the main editors (TemplateWizard, VisualEditor or the 2017 wikitext editor), even though they show in the auto-generated TemplateData documentation. They are replaced by a null string in input forms and by a space elsewhere.
Parametr | Popis | Příklad |
---|---|---|
description |
Parametr Výsledky Na stránce dokumentace šablon se popis zobrazí jako prostý text pod podnadpisem "Data šablony pro [název šablony]". Ve všech hlavních editorech (VisualEditor , Editor wikitextu 2017 a WikiEditor s TemplateWizard) se popis zobrazuje ve dvou hlavních případech:
V editoru wikitextu VisualEditor a 2017 bude popis zkrácen na přibližně 50 znaků pod každým návrhem vyhledávání, za ním následuje "...", ale celý popis se zobrazí v hlavním okně editoru šablon. Oba jsou zobrazeny šedým textem. V hlavním okně editoru šablon jsou popisy delší než čtyři řádky (asi 540 znaků) vybaveny samostatným posuvníkem a jsou zobrazeny černým textem. Pokud není uvedeno Pokud parametr popisu neexistuje nebo není zadán, zobrazí se text "Bez popisu." (No description) v dokumentaci TemplateData pod podtitulem "Data šablony pro [název šablony]" (Template data for [template name]). Dodatečně:
|
"description": "Šablona pro propojení na kategorii commons",
|
format |
Parametr Tento parametr není vyžadován, ale doporučuje se. Výchozí chování, když tento parametr neexistuje, je inline formátování a v dokumentaci TemplateData pod nadpisem tabulky se nezobrazí žádné odpovídající upozornění. Výsledky Inline: Pokud je parametr nastaven na
Když je šablona vložena, rozloží svůj wikitext na jediný řádek bez mezer mezi prvky. Například:
Blok: Pokud je parametr nastaven na
Když je šablona vložena, rozdělí své parametry každý na nový řádek s mezerami mezi jednotlivými prvky. Například: {{Foo | bar = baz | qux = quux }} Vlastní formátování: Alternativně, pokud je parametr nastaven na vlastní řetězec wikitextu, podle pravidel uvedených v sekci #Vlastní formáty, šablona zobrazí následující upozornění na předvolby v dokumentaci TemplateData:
Po vložení šablona rozloží svůj wikitext podle daného wikitextu. |
"format": "inline"
|
params |
Objekt Měl by obsahovat název každého parametru, za nímž následuje sada sub-parametrů TemplateData uvedených v sekci #Název parametru. Pokud existuje více parametrů, umístěte čárku mezi každý parametr objektu, ale žádný nepřidávejte za poslední složenou závorku (viz příklad). |
"params": {
"parameter1": {
... // informace o parametrech
}, // čárka zde
"parameter2": {
... // informace o parametrech
}, // a zde
"parameter3": {
... // informace o parametrech
} // ale tady ne
}
|
paramOrder |
How to use Přidejte parametr Parametry nemusí být na nových řádcích (mohou být We recommend you place Musíte zahrnout každý parametr uvedený v TemplateData. Jinak se zobrazí chyba "Nenalezena vyžadovaná vlastnost „správně pojmenovat“. (properlyname)". If not specified Without With other parameters V editoru wikitextu 2010 s TemplateWizard:
V aplikaci VisualEditor a editoru wikitext 2017 vynucuje |
"paramOrder": [
"date",
"reason",
"talk"
]
|
Parametry
Parametr | Popis | Příklad |
---|---|---|
Jméno parametru |
Jedinou položkou první úrovně objektu Například ve zdrojovém kódu šablony, pokud vidíte Můžete také vidět parametry s názvem
Poznámka: Uživatel může přesto vynutit použití How to use Každý z těchto objektů "Jméno parametru" (parametr name) by měl obsahovat všechny informace o parametru ve formě více TemplateData parametrů. Jsou uvedeny v následující části O názvu parametrů. |
"1": { // název parametru
... // informace o parametru najdete zde
}
|
O názvu parametru
Parametr | Popis | Příklad |
---|---|---|
aliases |
Volitelný parametr
or
To znamená, že pokud uživatel vloží některý z těchto parametrů hodnotou, provede stejnou funkci. To doslova znamená "Hodnota parameter1. Pokud parametr1 neexistuje nebo nemá hodnotu, hodnota parameter2." V druhém případě to také znamená: "Pokud parameter2 neexistuje nebo nemá hodnotu, tak žádná hodnota". Chcete-li vložit parametr |
"aliases": ["1", "talk", "talksection"],
|
inherits |
Chcete-li použít tento parametr, zadejte |
"params": {
"téma1": {
"label": "Téma",
"description": "Téma zmíněné na této disambiguační (nejednoznačné) stránce",
"type": "string"
},
"téma2": {
"inherits": "téma1"
},
"téma3": {
"inherits": "téma1",
"label" : "A different label"
}
}
|
label |
Parametr |
"label": "Měsíc a rok",
|
description |
Zde je |
"description": "Měsíc a rok, kdy byla šablona vložena",
|
type |
See the [[<tvar name=1>#Type parameter</tvar>|#Type parameter]] section. |
|
default |
Některé parametry šablony mají výchozí hodnotu. Hodnota se použije, pokud není přepsána uživatelem.
Položka Výsledky Ve všech hlavních editorech (VisualEditor, 2017 wikitext editor 2017 a 2010 wikitext editor s TemplateWizard) se S dalšími parametry Ve všech hlavních editorech (VisualEditor, 2017 wikitext editor a 2010 wikitext editor s TemplateWizard), je-li zadáno |
"default": "Category:CommonsRoot",
|
autovalue |
A parameter can be assigned an This value can be overwritten by the user in the template editor. S dalšími parametry Ve všech hlavních editorech (VisualEditor, 2017 wikitext editor a 2010 wikitext editor s TemplateWizard), |
"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}"
|
example |
Parametr Výsledky Ve všech hlavních editorech (VisualEditor, 2017 wikitext editor a 2010 wikitext editor s TemplateWizard). Tato vlastnost je zobrazena pod popisem parametru (a pod S dalšími parametry Ve všech hlavních editorech (VisualEditor, 2017 wikitext editor a 2010 wikitext editor s TemplateWizard) se |
"example": "January 2013",
|
required |
Pak máme Určuje, zda je vyplnění daného parametru pro šablonu povinné. Výsledky Tento stav má několik efektů v aplikaci VisualEditor a Editor wikitextu 2017 :
V WikiEditor na stránce Nápověda:Rozšíření:Šablonový pomocník , stejně jako v ostatních editorech se zobrazuje parametr automaticky, při vložení šablony uživatelem, ale parametr nelze odstranit pomocí tohoto ani žádného jiného editoru. V popisu parametru také nezobrazuje "Pole je povinné."; spíše uvádí parametr na straně v části "Povinné parametry". Kromě toho se obvykle chová stejně jako v ostatních editorech, kromě toho, že se v řádku zobrazí, že vstup neodpovídá očekávanému formátu. S dalšími parametry V aplikaci VisualEditor a editoru wikitext 2017 stav |
"required": true
|
suggested |
K dispozici je Use Výsledky V aplikaci VisualEditor a Editor wikitextu 2017 způsobí, že se parametr automaticky zobrazí, když uživatel vloží šablonu. Pokud má parametr nastavenou automatickou hodnotu, bude tato také automaticky ve vstupním poli parametru. Nemá žádný další účinek a nezobrazuje žádný další text ani varování. Ve WikiEditor s TemplateWizard neumisťuje parametr do šablony automaticky, ale místo toho způsobí, že bude uveden na straně v části "Doporučené parametry". Uživatel pak může kliknout na "+" vedle parametru a přidat jej do šablony. S dalšími parametry Stav |
"suggested": true
|
deprecated |
Nakonec je zde zastaralé Toto je stav pro parametry, které by se již neměly používat, ale prozatím existují. Může to být proto, že použití šablony se přesouvá z jedné sady parametrů do druhé. Výsledky Účinek tohoto parametru v aplikaci VisualEditor a editoru wikitext 2017 je, že po vložení parametru se vedle štítku parametru zobrazí šedý vykřičník a pod informačním popisem parametru je šedou kurzívou zobrazen text "Pole je zastaralé. důvod ukončení podpory". popis parametru. Nemá to vliv na funkčnost nebo použitelnost parametru ani nezobrazuje žádná další varování. Přestože může řetězec trvat, od ledna 2020 žádný z hlavních editorů (VisualEditor, editor wikitext 2017 nebo editor wikitext 2010) nezobrazí uživatelům obsah tohoto řetězce.
Zadání řetězce má stejný účinek jako V editoru wikitext 2010 s TemplateWizard nastavení této hodnoty jako S dalšími parametry Pokud nastavíte jak toto, tak Pokud nastavíte toto i V editoru wikitext 2010 s TemplateWizard, |
"deprecated": "Místo toho použijte 'publicationDate'."
|
suggested values |
The parameter property
Other types (file, page, template, user, date, boolean, URL) are not currently supported because they have special functionalities in the VisualEditor already, such as autocomplete, which would interfere with the drop-down menu for suggested values in the VisualEditor. Editing TemplateData as JSON in wikitext To add suggested values to any parameter type, add the new property "suggestedvalues" to the parameter in JSON. The “suggestedvalues” attribute must be a list of strings. Editing TemplateData with the TemplateData Editor
Effects Once the values have been added to TemplateData, the VisualEditor will display them in a combo box (a dropdown into which users can also enter a custom value) for the parameter types listed above. The user selects the desired value by clicking on it. If the list of values is long -- for example, a list of a country’s states -- the user can begin typing in the field, whereupon the list will be filtered to show only values containing the typed text. To change an entered value, the user must simply clear the field, and the full dropdown list will appear again. If the user needs a value not included in the list (for example, "message in a bottle") they can type it in manually. |
"suggestedvalues": [
"Journal",
"Book",
"Newspaper",
"Magazine"
]
|
Poznámka: Pokud ani "required"
, "suggested"
ani "deprecated"
nejsou pro parametr nastaveny jako true
, jeho stav se v dokumentaci TemplateData zobrazí jako "optional"
.
Až budete hotovi, stiskněte "Uložit". Pokud jste udělali chyby, nedovolí vám uložení (což je rušivé, ale znamená, že nic nemůžete zkazit). Pokud narazíte na chyby, vysvětlete na stránce zpětné vazby, co jste se snažili udělat a my vám rádi pomůžeme.
Pokud zneužíváte šablonu hack pro dynamické generování TemplateData, nelze ji před uložením zkontrolovat na chyby.
Všimněte si, že každá položka informací je uzavřena v uvozovkách (s výjimkou true
a false
) a je oddělena od dalšího bitu čárkou (pokud není poslední).
Zadejte parametr
Parametr "type"
je určen k tomu, aby editoru šablon signalizoval povahu hodnoty parametru.
V některých případech byly editory šablon naprogramovány tak, aby upravovaly uživatelské rozhraní pro určitý parametr podle hodnoty TemplateData, například tak, aby uživateli umožňoval zadávat pouze platné hodnoty, které odpovídají zadanému typu.
Tento parametr nemá žádný funkční účinek na parametr šablony nebo jeho hodnotu. Řídí pouze to, jak editoři šablon vidí a zpracovávají parametr v režimu úprav.
How to use
It is used by adding the "type"
parameter, followed by a colon and a space, then adding any of the values listed in the table below in quotation marks.
Example:
"type": "string",
Effects
As of February 2020, only 5 of the 13 type values have visible effects in VisualEditor and the 2017 wikitext editor, while 8 have visible effects in TemplateWizard.
The effects of certain values are likely to change as the template editors get updates to support them. One such effort for VisualEditor and the 2017 wikitext editor is tracked in the Phabricator task T55613. A similar effort to get TemplateWizard to support the boolean value is tracked in T200664.
Aktuálně známé účinky jsou následovné.
Value | Description | |
---|---|---|
unknown |
The Effects In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), | |
number |
Hodnota Effects
With other parameters
| |
string |
Hodnota Effects Ve všech hlavních editorech (VisualEditor, 2017 wikitext editor a 2010 wikitext editor s TemplateWizard) nemá | |
line |
Hodnota Effects
| |
boolean |
The Effects As of February 2020, none of the main Wikimedia editors (VisualEditor, 2017 wikitext editor or the 2010 wikitext editor with TemplateWizard) make use of this value. It has no visible effects. With the | |
date |
The Effects
With other parameters
| |
url |
Hodnota Effects
S dalšími parametry
| |
wiki-page-name |
Hodnota Effects Ve všech hlavních editorech (VisualEditor, editor wikitextu 2017 a editor wikitextu 2010 s TemplateWizard), | |
wiki-file-name |
Hodnota Effects
| |
wiki-template-name |
Hodnota Effects Ve všech hlavních editorech (VisualEditor, 2017 wikitext editor a wikitext editor 2010 s TemplateWizard) | |
wiki-user-name |
Hodnota Effects Ve všech hlavních editorech (VisualEditor, 2017 wikitext editor a 2010 wikitext editor s TemplateWizard) | |
content |
Hodnota Effects
| |
unbalanced-wikitext |
Hodnota Effects
|
Vlastní formáty
Při úpravě hodnoty "format"
vytvoříte vlastní formáty zadáním sady symbolů wikitextu pomocí některých předdefinovaných pravidel.
{{
- začátek šablony_
- obsah (např. řetězec, celé číslo nebo parametr). Toto podtržítko slouží k označení minimální délky hodnoty ve znakech a může být opakováno, například_______
. Není-li této délky dosaženo, vyplní zbývající znaky mezerami. To lze použít k zarovnání všech znamének rovná se na konkrétní pozici za parametr (pokud se použije s\n
pro nové řádky).|
- potrubí, trubka, svislá čára, svislítko (odděluje parametry)=
- znaménko rovná se (předchází hodnotě parametru)\n
nebo stisknutí klávesy Enter - nový řádek (ve vstupním poli se zobrazí jako↵
)\n
k odsazení nových řádků)}}
- konec šablony
Wikitext by měl splňovat minimálně {{_|_=_}}
, jinak dojde k neplatnosti řetězce formátového řetězce.
Úkol | Formátování řetězce | Výstup |
---|---|---|
Vložené formátování | {{_|_=_}} inline
|
{{Foo|bar=baz|qux=quux}}{{Bar}} |
Blokové formátování | {{_\n| _ = _\n}} block
|
{{Foo | bar = baz | qux = quux }}{{Bar}} |
Před názvem parametru není mezera,
každá šablona na vlastním řádku |
\n{{_\n|_ = _\n}}\n
|
{{Foo |bar = baz |qux = quux }} {{Bar}} |
Odsazení každého parametru | {{_\n |_ = _\n}}
|
{{Foo |bar = baz |qux = quux }}{{Bar}} |
Zarovnání všech názvů parametrů s danou délkou | {{_\n|_______________ = _\n}}\n |
{{Foo |bar = baz |qux = quux |veryverylongparameter = bat }} {{Bar}} |
Znaky svislitka na konci předchozího řádku | {{_|\n _______________ = _}}
|
{{Foo| bar = baz| qux = quux}}{{Bar}} |
Vložený styl s více mezerami musí být na začátku řádku | \n{{_ | _ = _}}
|
{{Foo | bar = baz | qux = quux}} {{Bar }} |
Šablona na začátku řádku, parametry zarovnány podle odsazení, potrubí vpředu | \n{{_ |\n _______________ = _}}
|
{{Foo | bar = baz | qux = quux}} {{Bar}} |
Prázdná předloha
Můžete zkopírovat prázdnou boilerplate níže a přidat do šablony nová data TemplateData. Zahrnuty jsou pouze nejběžnější značky.
<templatedata>
{
"description": "",
"params": {
"1": {
"label": "",
"description": "",
"type": ""
},
"2": {
"label": "",
"description": "",
"type": ""
}
}
}
</templatedata>
Chyby
Syntaktická chyba v JSON. / Bad JSON
K těmto chybám dochází při ukládání TemplateData, obvykle ručně upravovaných, s neplatným kódem JSON (duplicitní klíče/parametry, koncové nebo chybějící čárky atd.) ve VisualEditoru nebo v editoru wikitextu 2017.
"Syntaktická chyba v JSON." se objeví ve VisualEditoru a editoru wikitextu 2017. Při úpravách v editoru GUI TemplateData se zobrazí "Bad JSON format" (špatný formát JSON).
These errors can be difficult to detect and come in too many forms to list. The best way to avoid them is to edit template data exclusively with the TemplateData editor; the best way to detect them once they've occurred is to use an external JSON validator, such as JSONLint, which will highlight errors and aid in fixing them.
The 2010 wikitext editor does not check for invalid JSON thanks to an old, unfixed bug (úkol T128029). Pages that contain invalid JSON may throw alarming "Vnitřní chyba" messages. To fix these errors, your best bet is to use a JSON validator (see above).
Požadovaná vlastnost "paramOrder(number)" nebyla nalezena.
K této chybě dochází, pokud uvedete parametr v "params"
, který není uveden v "paramOrder"
.
Číslo v hranatých závorkách odkazuje na parametr v "paramOrder"
, který chybí. To odkazuje na jeho pořadí v sekvenci, ale to je o jeden méně než jeho skutečná pozice, protože "paramOrder"
je pole; 0 je první, 1 je druhý atd.
"params": {
"date": { ...
},
"reason": { ...
},
"talk": { ... // <-- This parameter is not stated in "paramOrder", but it should be.
}
},
"paramOrder": [
"date",
"reason"
]
// Error: Required property "paramOrder[2]" not found.
Chcete-li to vyřešit, ujistěte se, že všechny parametry uvedené v "params"
jsou uvedeny v "paramOrder"
.
Alternativně můžete odebrat objekt "paramOrder"
a tuto chybu odstranit.
Neplatná hodnota pro vlastnost "paramOrder(number)".
K této chybě dochází, pokud uvedete parametr v "paramOrder"
, který není uveden v "params"
.
Číslo v hranatých závorkách odkazuje na parametr v "paramOrder"
, který by tam neměl být. To odkazuje na jeho pořadí v sekvenci, ale to je o jedno méně než je jeho skutečná pozice, protože "paramOrder"
je pole; 0 je první, 1 je druhý atd.
"params": {
"date": { ...
},
"talk": { ...
}
},
"paramOrder": [
"date",
"reason", // <-- This parameter is not stated in "params", but it should be.
"talk"
]
// Error: Invalid value for property "paramOrder[1]".
Chcete-li to vyřešit, ujistěte se, že všechny parametry uvedené v "paramOrder"
jsou uvedeny v "params"
.
Alternativně můžete odebrat objekt "paramOrder"
a tuto chybu odstranit.
Očekává se, že vlastnost params.parametername.required" bude typu "boolean".
K této chybě dochází, pokud uvozovky umístíte kolem hodnoty buď "required"
nebo "suggested"
.
"suggested": "true" // <-- These quotation marks shouldn't be here.
Toto jsou booleovské hodnoty, nikoli řetězce, proto nevyžadují žádné uvozovky.
Chcete-li to vyřešit, odeberte uvozovky kolem hodnot true
nebo false
pro tyto parametry.
Očekává se, že "format" vlastnosti bude ...
Pokud parametr "format"
existuje, ale jeho hodnota není "inline"
, "block"
nebo platný řetězec formátu, zobrazí se chybová zpráva: "U vlastnosti „format“ se očekává hodnota „inline“, „block“ nebo platná hodnota formátu".
"format": "notinline"
// Error : Property "format" is expected to be "inline", "block", or a valid format string.
Chcete-li to vyřešit, ujistěte se, že hodnota po "format":
se rovná "inline"
nebo "block"
a že nedochází k pravopisným chybám. Pokud je to wikitext, ujistěte se, že obsahuje minimálně {{_|_=_}}
a že v syntaxi nejsou chyby, které by normálně způsobily selhání šablony. Jako jsou duplicitní znaménka rovná se nebo chybějící nebo duplicitní složené závorky; viz část #Vlastní formáty pro syntaxi vlastních formátů.
Alternativně můžete odstranit tuto chybu pomocí parametru "format"
.
Neočekávaná vlastnost "parametername".
This error occurs if you state a parameter that does not exist in TemplateData. This is probably due to spelling mistakes.
<templatedata>
{
"description": "",
"format": "inline",
"params": {
"1": {
"label": "",
"descriptino": "", // <-- spelling mistake
"type": ""
}
}
}
</templatedata>
Dochází k ní také v případě, že uvedete parametr v jakémkoli objektu TemplateData, který není parametrem daného objektu. Může to být způsobeno pravopisnými chybami, nebo jste možná zapsali parametr jednoho objektu TemplateData pod jiný objekt, ke kterému nepatří.
Například byste mohli napsat parametr "label"
pod kořenový objekt TemplateData namísto uvnitř "params"
:
<templatedata>
{
"description": "",
"format": "inline",
"label": "", // <-- incorrectly placed parameter
"params": {
"1": { // ↓ it should be in here
"description": "",
"type": ""
}
}
}
</templatedata>
Pokud je neočekávaný parametr pod parametrem šablony uvnitř "params"
, uvidíte jeho název za "params.parametername." omylem.
Chcete-li provést opravu, ujistěte se, že v názvech parametrů nejsou žádné pravopisné chyby a ujistěte se, že vaše parametry jsou správně umístěny. Additionally, make sure you don't state any parameters that don't exist for a TemplateData object. You can check which parameters exist for an object in the section #TemplateData parameters.
Požadovaná vlastnost "params" nebyla nalezena.
K této chybě dochází, pokud v TemplateData není žádný objekt "params"
.
Toto je nezbytný objekt, protože obsahuje všechny podrobnosti o každém parametru, takže tuto chybu opravte, ujistěte se, že je přidána a že nedochází k pravopisným chybám.
Viz část výše o tom, jak přidat parametr "params"
.
Omezení a zpětná vazba
- Chybějící funkce – TemplateData je příkladem nástroje, který byl zpřístupněn s několika funkcemi, v naději, že by uživatelé pomohli řídit vývoj funkcí, které požadovali. Pokud chcete požádat o nové funkce pro TemplateData, dejte nám prosím vědět na [1].
- Prodlevy při zobrazování v šablonách – Po přidání TemplateData do šablony by měla být metadata viditelná okamžitě, jakmile se šablona otevře ve vizuálním editoru. Je však možné, že to bude trvat několik hodin, než se metadata zobrazí. Aktualizace můžete vynutit provedením nulové úpravy samotné stránky šablony (nikoli podstránky dokumentace). Chcete-li provést nulovou úpravu, otevřete stránku šablony pro úpravy a stránku uložte bez jakékoli změny a bez přidání souhrnu úprav.
- Aktuální problémy – Seznam aktuálních chyb a požadavků na funkce je k dispozici v nástroji pro sledování chyb Wikimedia.
Další nástroje
- Nápověda:Rozšíření:Šablonový pomocník
- Dialogové okno panelu nástrojů pro zadávání wikitextů šablony pomocí formuláře vytvořeného z TemplateData.
- TemplateData Wizard
- Nástroj, který generuje TemplateData prostřednictvím interaktivního rozhraní.
- Skeleton TemplateData generator
- Nástroj, který čte zdrojovou šablonu wikicodu a snaží se najít všechny použité parametry a vydá dokument kostry s uvedenými parametry.
- JSONLint
- Nástroj, který vám umožní ověřit ručně napsaný JSON, který pomůže najít chyby v syntaxi.
- Seznam všech šablon s TemplateData na této wiki
- S dewiki template TemplateData jsou data šablony zobrazena v rámečku a šablona je přidána do kategorie šablon se šablonou data
- https://query.wikidata.org/ and Query Helper