Jump to content

Template:Skin

Sledovač problémů: [[phab:tag/{{{phabricator}}}/|#{{{phabricator}}}]]
From mediawiki.org
This page is a translated version of the page Template:Skin and the translation is 100% complete.
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 neplatné
MediaWiki {{{mediawiki}}}
PHP {{{php}}}
Composer {{{composer}}}
Licence {{{license}}}
Ke stažení {{{download}}}
{{{readme}}}
{{{changelog}}}
Příklad {{{example}}}
Parametry
{{{parameters}}}
{{{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
namená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.
statusaktuá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).

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:

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
updatedatum poslední aktualizace
compatibility policy zásady kompatibility (přijaté hodnoty jsou master, rel a ltsrel). (backlog )
mediawikipožadovaná verze MediaWiki
phppožadovaná verze PHP
licenselicence upravující použití tohoto vzhledu, např. GPL
downloadodkaz na stažení: Use {{WikimediaDownloadSkin }} or {{GithubDownload }}.
readmeexterní odkaz na soubor readme
changelogexterní odkaz na soubor changelog
parametersdostupné parametry na LocalSettings.php
examplenapříklad webová stránka nebo snímek obrazovky pracovního vzhledu
compatibilitygraf kompatibility
bugzillaná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:

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.