Manual:$wgResourceModuleSkinStyles/cs

Globální $wgResourceModuleSkinStyles umožňuje vzhledům poskytovat další šablony stylů pro přizpůsobení existujících modulů ResourceLoader. Vzhledy jej mohou upravit úpravou klíče ResourceModuleSkinStyles v souboru skin.json. Rozšíření mohou upravit své styly modulů podle vzhledů nastavením klíče skinStyles v definicích modulu ResourceLoader.

To usnadňuje (nebo je to vůbec možné) přepsat výchozí styly a snižuje nároky na styl vzhledu tím, že se na většině stránek nenačítají nepoužívané styly. Pokud má například vzhled mnoho kódu CSS pro přepsání vzhledu stránky Special:UserLogin, může to vložit do samostatného souboru CSS nebo LESS, který přepíše 'mediawiki.special.userlogin.login.styles' a ResourceLoader načte CSS tohoto vzhledu pouze tehdy, když stránka tento modul vyžaduje.

$wgResourceModuleSkinStyles je vícerozměrné pole. Na první úrovni obsahuje název balíčku (skin/extension), který přidává další styly (v následujícím příkladu s názvem "foo"). On the second level it contains key-value-pairs:


 * Klíčem jsou vždy názvy modulů, pro které by měly být použity další styly. Ve výchozím nastavení pak vaše definice nahradí soubor CSS/LESS, který již dříve definoval styly pro tento modul. Pokud je před názvem modulu naopak znaménko "+", vaše styly budou "přidány" k těm stylům, které již byly definovány dříve, takže nenahradí úplné soubory, ale "zachová" všechny styly a pouze přepisovat/přidávat ty, které definujete.
 * Value (hodnota) je relativní cesta k příslušnému souboru. Do modulu lze přidat více souborů jejich zapsáním do pole.

Vector je jedním ze vzhledů využívajících tuto metodu a poskytuje dobrou praktickou [ukázku použití https://phabricator.wikimedia.org/diffusion/SVEC/browse/master/skin.json]. Definici naleznete pod klíčem.

Základní informace o definování a používání modulů ResourceLoader naleznete v dokumentaci k.

Dokumentace
Klíč ResourceModuleSkinStyles uvnitř skin.json lze použít ke změně stylů známých modulů ResourceLoader, které byly definovány v klíči ResourceModules jiných rozšíření.

Styly definované pomocí $wgResourceModuleSkinStyles jsou později přidány do seznamu  existujícího modulu. Seznam  nelze upravit ani zakázat.

Pokud je to například definice modulu ResourceLoader bar:

takto by vzhled Foo poskytoval další styly:

To je většinou ekvivalentní:

Pokud modul již definuje svůj vlastní záznam v  pro daný vzhled, pak je $wgResourceModuleSkinStyles ignorován.

Pokud modul definuje, vzhled je možná bude chtít rozšířit, místo aby je nahradil. To lze provést pomocí předpony.

Příklad:

To je většinou ekvivalentní:

Jinými slovy, jako autor modulu použijte seznam  pro šablony stylů, které nemusí být deaktivovány vzhledem. Chcete-li poskytnout výchozí styly, které lze rozšířit nebo nahradit, použijte.

Stejně jako u $wgResourceModules jsou výchozí cesty relativní ke kořenu MediaWiki. Vždy byste měli zadat  a   (nebo  / ).

Příklad:



Vymazání stylů uživatelského rozhraní MediaWiki
Core MediaWiki přidává CSS modulů MediaWiki UI  jako   , což umožňuje vzhledům přepsat jejich styl. Extrémní příklad pro odstranění většiny stylingu: