Rozšíření:TemplateStylesExtender

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

TemplateStylesExtender Stav rozšíření: stabilní
Implementace	Rozšíření syntaktického analyzátoru
Popis	Rozšiřuje Extension:TemplateStyles o nové selektory
Autoři	Octfxdiskuse
Nejnovější verze	2.2.0
Zásady kompatibility	Větev master zachovává zpětnou kompatibilitu.
MediaWiki	>= 1.43.0
PHP	>=8.0
Změny v databázi	Ne
Composer	octfx/template-styles-extender
Parametry $wgTemplateStylesExtenderExtendCustomPropertiesValues $wgTemplateStylesExtenderEnableUnscopingSupport $wgTemplateStylesExtenderCustomPropertiesDeclaration $wgTemplateStylesExtenderUnscopingPermission
Použité háčky (hooks) ParserFirstCallInit TemplateStylesPropertySanitizer TemplateStylesStylesheetSanitizer
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	GitHub: stránka projektu URL úložiště git zobrazit historii

Rozšíření TemplateStylesExtender rozšiřuje Extension:TemplateStyles o nové selektory a párovače. Modul TemplateStylesExtender je vyvinut na základě modulu css-sanitizer 5.5.0, který používá modul MediaWiki 1.43 .

Funkce

• Deklarujte vlastní vlastnosti/proměnné CSS
• Používejte vlastní vlastnosti/proměnné CSS ve většině vlastností
• Implementujte další vlastnosti a hodnoty, jak je uvedeno níže

Modul	Změny	Úkol
Modul základního uživatelského rozhraní úrovně 4	Přidané vlastnosti: pointer-events	T342271
Modul pro dimenzování boxů, úroveň 4	Zpětně portováno na css-sanitizer 5.5.0	T375344
Kaskádování a dědičnost úrovně 5	Přidané vlastnosti: revert-layer	-
Barevný modul úroveň 4	Přidáno: Alfa-hexadecimální notace	T265675
Barevný modul úroveň 5	Přidané vlastnosti: Relative color, color()	-
Zadržovací modul úrovně 3	Přidané vlastnosti: contain, content-visibility	-
Modul filtrových efektů úroveň 2	Přidané vlastnosti: backdrop-filter	-
Modul písmen úroveň 4	Přidané vlastnosti: font-optical-sizing, font-variation-settings, ascent-override, descent-override, font-display, line-gap-override	-
Modul písmen úroveň 5	Přidané vlastnosti: size-adjust	-
Maskovací modul úrovně 1	Přidané vlastnosti: -webkit-mask-image	-
Modul rozvržení anotací v Ruby, úroveň 1	Přidané vlastnosti: ruby-align, ruby-position	T277755
Modul Snap pro posouvání úrovně 1	Přidané vlastnosti: scroll-margin, scroll-padding, scroll-snap-align, scroll-snap-stop, scroll-snap-type	T271598
Modul Hodnoty a jednotky úroveň 4	Přidaná funkce: clamp()	T394619

Instalace

• Ke stažení soubor/y a vložte je do adresáře pojmenovaného TemplateStylesExtender ve vaší složce extensions/.
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'TemplateStyles' );
  wfLoadExtension( 'TemplateStylesExtender' );
  

• 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.

Nastavení

Nastavení	Popis	Výchozí
$wgTemplateStylesExtenderCustomPropertiesDeclaration	Povolit deklaraci vlastních vlastností CSS (proměnných CSS) jako vlastností	true
$wgTemplateStylesExtenderExtendCustomPropertiesValues	Povolit použití vlastních vlastností CSS (proměnných CSS) jako hodnot ve všech vlastnostech	true
$wgTemplateStylesExtenderEnableUnscopingSupport	Umožňuje uživatelům s oprávněním unscope zrušit rozsah CSS nastavením atributu wrapclass.	false
$wgTemplateStylesExtenderUnscopingPermission	Zadejte skupinu oprávnění, která má povoleno zrušit rozsah CSS.	editinterface

Poznámka k proměnným CSS

Aktuální použití selektorů :root nebude fungovat kvůli stylům šablon, které předčí .mw-parser-output.

Jedním z možných řešení je zabalit celý obsah do elementu 'div' a přidat k němu deklarace, např.

div#content-wrap {
   --padding: 10px
}

.content {
   padding: var( --padding )
}

Wikitext

<div id="content-wrap">
   <div class="content">
      The WikiText...
   </div>
</div>

Zrušení rozsahu CSS

Příklad: Hodnota ‎<templatestyles src="Foo/style.css" wrapclass="mediawiki" /> má za následek, že CSS bude mít rozsah .mediawiki místo .mw-parser-output.

Zahrnutí takového volání na stránku v podstatě omezuje úpravy na uživatele s právem editinterface. Alternativně můžete zahrnout volání šablony, která obsahuje styly.

Související odkazy

• Extension:TemplateStyles