Template:Skin

Template documentation

Tato šablona by měla být přidána na všechny stránky vzhledu na této wiki (ale pouze na hlavní stránku), aby se zobrazilo informační pole a kategorizoval vzhled.

Použití

Zkopíruj a vlož: {{Skin|templatemode = |name = |localised name = |status = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |composer = |license = |download = |readme = |changelog = |example = |parameters = |compatibility = |bugzilla = |phabricator = |vagrant-role = }} Jaký má být obsah parametrů, viz níže

Příručka k zobrazením MediaWiki - kategorie {{{localised name}}} Stav rozšíření: neznámé Popis {{{description}}} Napsal(i) SomeAuthor Nejnovější verze {{{version}}} ({{{update}}}) Poslední verze náhledu {{{version preview}}} ({{{update preview}}}) Zásady kompatibility MediaWiki {{{mediawiki}}} PHP {{{php}}} Composer {{{composer}}} Licence {{{license}}} Ke stažení {{{download}}} {{{readme}}} {{{changelog}}} Příklad {{{example}}} Parametry {{{parameters}}} Použité háčky (hooks) hook1 hook2 Poskytované háčky (hooks) newhook1 newhook2 {{{compatibility}}} Přeložte rozšíření $2, používá-li lokalizaci z translatewiki.net Vagrant role {{{vagrant-role}}} Problémy : [[phab:tag/{{{phabricator}}}|Otevřené úkoly]] · Nahlásit chybu

Obsah parametrů

Tato část popisuje parametry, kterými se řídí obsah infoboxu. Nápovědu s templatemode a dalšími ovládacími parametry naleznete v Kontrolních parametrech.

Obsah parametrů

Parametr	Popis
name	název vzhledu
localised name	zdrojový text pro lokalizaci názvu vzhledu Zadejte stejnou hodnotu jako name. Později se použije pro lokalizaci názvu.
status	aktuální stav vydání Jeden z: unstable - aktuálně nefunkční – nepoužívejte tento vzhled v nejnovější verzi MediaWiki. experimental - ranná stádia vývoje, se mohou drasticky změnit beta - stabilní, ale ne plně testované stable - stabilní - vzhled funguje v nejnovější verzi MediaWiki bez fatálních chyb. unmaintained - neudržovaný – použijte pouze v případě, že je propojené úložiště archivováno nebo správce neodpověděl na dotaz ohledně udržovaného stavu. Používáte-li tento stav, uveďte odkaz na opravu nebo zprávu o problému/chybě jako referenci pomocí komentáře HTML. Pokud je zobrazení rozbité, použijte místo něj unstable. unknown - výchozí Pokud je stav jiný než výše uvedený, bude ignorován a v šabloně bude místo toho zobrazena výchozí hodnota 'Neznámé' (Unknown). barevné schéma stavu vydání
hook1 hook2 hook3 hook4 ... hook90	háčky používané rozšířeními Zadání hodnot do tohoto pole je dobrým způsobem, jak získat další rozšíření pro vaše rozšíření a jak pomoci ostatním vývojářům. Každý dokumentovaný háček automaticky přidá rozšíření do seznamu kategorií rozšíření, které tento háček používají. Tato kategorie je automaticky propojena do každé stránky s háčky, aby programátoři snadno našli příklady rozšíření, která používají konkrétní háček. Pro vestavěné háčky: použijte název háčku samostatně. Hodnoty najdete v příručce Manual:Hooks (ale vynechejte úvodní '/'). Pro vlastní háčky definované rozšířeními: použijte extensionName/hookName. Pro seznam vlastních háčků viz Extension hook registry. U více háčků přiřaďte první háček k hook1, druhý k hook2 atd.
newhook1 newhook2 newhook3 newhook4 ... newhook90	název každého háčku poskytnutého rozšířením Možná budete chtít přidat háčky do Extension hook registry.
username	Uživatelské jméno autora na MediaWiki.org (pokud nějaké má). Může být vynecháno, ale bude-li přítomen, bude použit k propojení s autorovou stránkou a stránkou user_talk. Mělo by být poskytnuto bez jmenného prostoru a bez [[]].
author	Jméno autora vzhledu, pokud se liší od jeho uživatelského jména MediaWiki.org. Libovolný text. Pokud je vynecháno, použije se pole 'username' (pokud existuje).
description	stručný popis
image	snímek obrazovky nebo logo vzhledu Měl by být poskytován bez jmenného prostoru a bez [[]].
imagesize	nepovinné, velikost obrázku (výchozí velikost je 220px)
version	poslední verze
update	datum poslední aktualizace
compatibility policy	zásady kompatibility (přijaté hodnoty jsou master, rel a ltsrel). (backlog )
mediawiki	požadovaná verze MediaWiki
php	požadovaná verze PHP
license	licence upravující použití tohoto vzhledu, např. GPL
download	odkaz na stažení: Use {{WikimediaDownloadSkin }} or {{GithubDownload }}.
readme	externí odkaz na soubor readme
changelog	externí odkaz na soubor changelog
parameters	dostupné parametry na LocalSettings.php
example	například webová stránka nebo snímek obrazovky pracovního vzhledu
compatibility	graf kompatibility
bugzilla	název komponenty vzhledu Bugzilla MediaWiki

Kontrolní parametry

Kontrolní parametry

Parametr

Popis

templatemode

Řídí automatickou kategorizaci hostitelské stránky. Normálně ponecháno prázdné. Alternativní hodnoty jsou: nocats - potlačuje kategorizaci. Tuto hodnotu použijte, pokud přidáváte tuto šablonu do podstránky vzhledu nebo do dokumentace vzhledů. Například výše uvedený obrázek použití nastavuje templatemode=nocats, protože toto není skutečná stránka vzhledu a nechceme kvůli tomu tuto stránku přidat do žádných kategorií. Pokud toto ponecháte prázdné, šablona přidá hostitelskou stránku do Kategorie:Všechny vzhledy a do jedné nebo více dalších kategorií v závislosti na hodnotách přiřazených parametrům obsahu. podstránka; není ve Skin: namespace; nebo pokud je potlačeno 'templatemode=nocats'

Přidání kategorií

Tato šablona automaticky přidá stránky, na kterých se používá, do kategorie Category:All skins.

Kromě toho bude stránku kategorizovat na základě hodnoty parametru status:

• unstable: Category:Unstable skins
• experimental: Category:Experimental skins
• stable: Category:Stable skins
• beta: Category:Beta status skins
• unmaintained: Category:Unmaintained skins
• otherwise: Category:Skins with unknown status

Použití infoboxu

Stávající stránky vzhledu

Pokud chcete přidat infobox na stránku, která již existuje, zkopírujte do ní výše uvedený kód.

Vytvoření nové stránku vzhledu

Pokud chcete vytvořit novou stránku vzhledu, zadejte název níže a klikněte na tlačítko. Tím dojde k založení nové stránky, která již bude tuto informační šablonu obsahovat.

Please replace "TheSkin" with your skin's name:

MediaWiki is an open-source project and users are encouraged to make any MediaWiki skins under an Open Source Initiative (OSI) approved GPLv2 compatible license (including MIT, BSD, PD). For skins that have a compatible license, you can request commit access to the MediaWiki source repository for skins.

Vývojář sdílející svůj kód v úložišti kódu by měl očekávat:

Zpětná vazba / Kritika / Recenze kódu

Recenze a komentáře ostatních vývojářů k věcem, jako je [použití rámce https://doc.wikimedia.org/], zabezpečení, efektivita a použitelnost.

Vývojářské ladění

Ostatní vývojáři upravující váš příspěvek, aby vylepšili nebo vyčistili váš kód, aby vyhovoval novým třídám a metodám rámce, kódovacím konvencím a překladům.

Budoucí verze od jiných vývojářů

Nové větve vašeho kódu jsou vytvářeny jinými vývojáři, když jsou vydávány nové verze MediaWiki.

Kredit

Poděkování za zachování vaší práce v budoucích verzích

Podobně byste měli připsat zásluhy vývojářům všech vzhledů, jejichž kód si vypůjčíte.

Žádný vývojář, kterému je nepříjemná jakákoli z těchto akcí, by neměl hostit svůj kód v úložišti kódu. Stále se doporučuje vytvořit souhrnnou stránku pro svůj vzhled na wiki, aby lidé věděli o vzhledu a kde si jej mohou stáhnout.

Vylepšení této šablony

Pokud byste chtěli tuto šablonu vylepšit, děkujeme! Toto je složitá šablona, takže zde je nápověda:

Navíc Template:Skin/Sample ukládá základ, který je předem načten do nově vytvořených stránek a obsahuje základní dokumentaci, jak vyplnit parametry šablony. Musí být synchronizován s dokumentací.

Tlačítko Vytvořit vzhled

Chcete-li zlepšit chování tlačítka vytvořit vzhled:

• Template:Skin/Sample — Standardní vzhled, který je předem načten do nově vytvořených stránek.
• Template:Skin/CreateSkinInputBox — Vstupní pole, které lze vložit kamkoli chcete, aby uživatelé snadno vytvářeli vzhledy. Dokumentaci ke značce ‎<inputbox> naleznete v části Rozšíření:InputBox .
• Skin:TheSkin: — Definuje zástupný symbol pro případ, že uživatel omylem stiskne tlačítko vytvořit, aniž by změnil název vzhledu.

Parametry Infoboxu

Obecně:

• Aby se tato šablona snadno používala, je každý štítek v informačním poli propojen s dokumentací parametrů šablony, které zobrazuje. Pokud přidáte parametr, nezapomeňte jej také přidat do dokumentace parametrů obsahu a propojit jeho štítek s touto dokumentací.

Testovací případy

Po úpravě této šablony se podívejte, zda jsou následující stránky stále v pořádku.

• Vzhled:Vector
• Template:Skin

Editors can experiment in this template’s sandbox (create | mirror) and testcases (create) pages.
Subpages of this template.