Extension:CSS

Příručka k rozšířením MediaWiki

CSS Stav rozšíření: stabilní
Implementace	Funkce analyzátoru
Popis	Poskytuje funkci analyzátoru pro přidávání souborů CSS, článků nebo vložených pravidel do článků
Autoři	Aran Dunkley Rusty Burchfield
Nejnovější verze	3.5.0
MediaWiki	>= 1.43.0
Parametry $wgCSSIdentifier
Použité háčky (hooks) ParserFirstCallInit RawPageViewBeforeOutput
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Příklad	organicdesign.nz
Přeložte rozšíření CSS, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření CSS umožňuje zahrnout šablony stylů CSS do konkrétních článků. CSS může být jiný článek, soubor nebo to mohou být pravidla definovaná přímo ve funkci parseru.

Použití

Pokud máte například článek CSS s názvem "MyStyles.css", což jsou styly určené pro použití s článkem "MyFancyUserPage", přidali byste do článku následující syntaxi funkce analyzátoru,

{{#css:MyStyles.css}}

Pokud by na druhou stranu "MyStyles.css" byl soubor v adresáři /wiki/skins, pak by byl zahrnut, jak je uvedeno níže. Všimněte si, že soubor musí být absolutní cesta s úvodním lomítkem, aby se odlišil od názvu článku.

{{#css:/skins/MyStyles.css}}

Alternativně mohou být pravidla CSS zahrnuta přímo do funkce parser (inline), jako v následujícím příkladu,

{{#css:
  body {
    background: yellow;
    color: red;
    font-size: 1.25rem;
  }
}}

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného CSS ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CSS
  

• Při instalaci z Gitu spusťte Composer pro instalaci závislostí PHP zadáním composer install --no-dev v adresáři rozšíření. (Vyskytnou-li se nějaké komplikace, podívejte se na T173141.)
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'CSS' );
  

• Vyžaduje nastavení v konfiguračním souboru.
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Konfigurace

Volitelně můžete nastavit základní URL pro externí soubory.

$wgCSSPath = false;  # Výchozí, vzhledem k $wgScriptPath
$wgCSSPath = '';  # Relativně ke kořenovému adresáři vašeho serveru
$wgCSSPath = 'https://example.org/stylesheets';  # Relativní k jinému webu

Tipy

Změna barvy nebo pozadí konkrétní stránky

Použití funkce analyzátoru k použití CSS z jiné stránky nefunguje ke změně barvy nebo pozadí stránky, ale použití funkce analyzátoru na jedné stránce samotné umožňuje změnu pozadí. K překonání tohoto problému je možné načíst CSS pomocí transkluze, což nezpůsobuje problém s nenačtením změny na pozadí stránky.

Související odkazy

• Extension:NewPageCSS
• Extension:TemplateStyles - podobné rozšíření, které vyčistilo CSS a uložilo je na samostatné stránky.