Skin:Vector/2022

Příručka k zobrazením MediaWiki - kategorie

Vector 2022 Stav rozšíření: stabilní
Zásady kompatibility	Vydání snímků následuje MediaWiki. Master zachovává zpětnou kompatibilitu.
Composer	mediawiki/vector-skin
Licence	GNU General Public License 2.0 nebo pozdější
Ke stažení	Stáhnout zobrazení Git [?]: stáhněte si Git master procházet úložiště (Phabricator · GitHub) zobrazit historii přispěvatelé repozitáře (GitHub) kontrola kódu
Příklad	https://en.wikipedia.org/ https://vi.wikipedia.org/ https://test.wikipedia.org/
Parametry $wgVectorNightMode $wgVectorResponsive $wgVectorStickyHeader $wgVectorMaxWidthOptions $wgVectorFontSizeConfigurableOptions $wgVectorLanguageInHeader $wgVectorLanguageInMainPageHeader $wgVectorWvuiSearchOptions $wgVectorTableOfContentsCollapseAtCount $wgVectorPromoteAddTopic $wgVectorWrapTablesTemporary $wgVectorWebABTestEnrollment $wgVectorDefaultSkinVersionForNewAccounts $wgVectorDefaultSkinVersionForExistingAccounts
Čtvrtletní stahování	0
Používání veřejných wikin	14,010 (Ranked 2nd)
Veřejné wikiny používající jako výchozí vzhled	5,943
Přeložte rozšíření $2, používá-li lokalizaci z translatewiki.net
Vagrant role	vector
Problémy :	Otevřené úkoly · Nahlásit chybu

Vector 2022 je vzhled MediaWiki, který je druhou evolucí vzhledu Vector. Byl vyvinut jako součást projektu Vylepšení plochy. Je součástí MediaWiki od MediaWiki 1.38 . Je to výchozí vzhled pro různé projekty Wikimedie.

Vector 2022 se od většiny vzhledů liší tím, že nemá vlastní kódovou základnu. Jeho kód je spíše součástí vzhledu Vector a oba se stahují společně.

Verze MediaWiki 1.38 tohoto vzhledu je označena oficiální podporou třetích stran. Pamatujte, že weby s MediaWiki 1.36 nebo 1.37 používají Vector 2022 a při aktualizavci na verzi 1.38 se setkají s problémy. Další podrobnosti viz T299104 a Rozšíření:WikimediaMaintenance .

Instalace

Tento vzhled je součástí MediaWiki verze 1.38 a vyšších. Zbývající konfigurační pokyny je stále nutné dodržovat.

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Vector ve vaší složce skins/.
• Na konec vašeho souboru LocalSettings.php přidejte řádek s následujícím kódem:

  wfLoadSkin( 'Vector' );
  

• Nakonfigurujte podle potřeby.
• Dokončeno - Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo zobrazení úspěšně nainstalováno.

Volitelné závislosti

Vector 2022 může používat následující rozšíření, pokud jsou nainstalována, i když žádná nejsou vyžadována:

• UniversalLanguageSelector – pro tlačítko přepínání jazyka
• PageImages – pro zahrnutí obrázku pro každou stránku (pokud je k dispozici) do vyhledávacího pole
• ShortDescription – zahrnout popis pro každou stránku do vyhledávacího pole (projekty Wikimedia mají podobnou funkci, ale nepoužívají toto rozšíření)

Konfigurace

Provedení Vector 2022 jako výchozí vzhled

Od MediaWiki 1.38 a vyšší přidejte k LocalSettings.php následující, aby se Vector 2022 stal výchozím skinem:

$wgDefaultSkin = 'vector-2022';

Funkce

Noční režim

Verze MediaWiki:

1.43

Vector 2022 obsahuje noční režim nebo tmavý režim, který má tři možné stavy:

• day – také známý jako světlý režim
• night – také známý jako tmavý režim
• os – také známý jako automatický. Tento režim se automaticky přizpůsobí stavu operačního systému nebo prohlížeče

Noční režim je chráněn příznakem funkce. Chcete-li to povolit, nastavte $wgVectorNightMode takto:

$wgVectorNightMode['beta'] = true;
$wgVectorNightMode['logged_out'] = true;
$wgVectorNightMode['logged_in'] = true;

Je-li povoleno, výchozí režim motivu je den. Chcete-li změnit výchozí motiv pro všechny uživatele na automatický režim nebo noční režim, nastavte výchozí nastavení pro uživatelskou možnost buď:

$wgDefaultUserOptions['vector-theme'] = 'os';
// nebo 
$wgDefaultUserOptions['vector-theme'] = 'night';

Vezměte prosím na vědomí, že váš obsah musí být kompatibilní s nočním režimem. Možná si budete chtít přečíst doporučení pro wikiny Wikimedie .

Konfigurovatelnost

Všimněte si, že Vector 2022 má několik nestabilních příznaků funkcí, které mohou kdykoli zmizet. Většina těchto příznaků funkcí se týká neúplných funkcí. Nedoporučujeme měnit žádný příznak funkce z jeho výchozí hodnoty, pokud zde není uvedeno.

• $wgVectorMaxWidthOptions - lze použít ke konfiguraci, zda se použije maximální šířka. V tuto chvíli relativně stabilní.
• $wgVectorLanguageInMainPageHeader - určuje, zda se tlačítko jazyka zobrazí na hlavní stránce v záhlaví.
• $wgVectorTypeahead - asociativní pole s konfiguračními klíči pro adresy URL API a možnostmi, jako například showDescription a showThumbnail (obě booleovské hodnoty).

Možnosti připnutí nabídky

Vector 2022 umožňuje kontrolu nad tím, zda se různé nabídky zobrazují jako připnuté v postranním panelu nebo sbalené v záhlaví. Tyto možnosti mohou být konfigurovány jak uživateli v jejich předvolbách, tak správci jako výchozí nastavení.

K dispozici jsou následující možnosti připnutí:

• vector-main-menu-pinned – ovládá pozici hlavní navigační nabídky
  • 1 (výchozí) – nabídka je připnutá v levém postranním panelu
  • 0 – nabídka je sbalená do ikony hamburgeru v záhlaví
• vector-page-tools-pinned – ovládá pozici nabídky nástrojů stránky
  • 1 (výchozí) – nástroje jsou připnuty v pravém postranním panelu
  • 0 – nástroje jsou sbaleny do ikony záhlaví
• vector-toc-pinned – ovládá pozici obsahu
  • 1 (výchozí) – obsah je připnut v levém postranním panelu
  • 0 – obsah je sbalen do plovoucího tlačítka
• vector-appearance-pinned – ovládá pozici nabídky vzhledu
  • 1 (výchozí) – možnosti vzhledu jsou připnuté na postranním panelu
  • 0 – možnosti vzhledu jsou sbaleny do ikony záhlaví

Chcete-li změnit kterékoli z těchto výchozích nastavení pro přihlášené uživatele, přidejte odpovídající řádky do LocalSettings.php:

Upozorňujeme, že toto nebude fungovat pro anonymní uživatele, dokud nebude vypracována T366999.

// Příklad: Sbalení všech nabídek
$wgDefaultUserOptions['vector-main-menu-pinned'] = 0;
$wgDefaultUserOptions['vector-page-tools-pinned'] = 0;
$wgDefaultUserOptions['vector-toc-pinned'] = 0;
$wgDefaultUserOptions['vector-appearance-pinned'] = 0;

Workarounds

Varování:

Tento kód by se nikdy neměl spouštět na produkčních stránkách Wikimedie, protože způsobuje opětovné vykreslování stránky, což může mít dopad na SEO i uživatelský zážitek.

Chcete-li ve výchozím nastavení připnout postranní panel pro anonymní uživatele, můžete na začátek řetězce MediaWiki:Common.js přidat tento kód (viz živý příklad):

if (!mw.config.get('wgUserName')) {
	const observer = new MutationObserver((mutationsList, observer) => {
		for (const mutation of mutationsList) {
			if (mutation.target.classList.contains('vector-animations-ready')) {
				document.querySelector( '[data-event-name="pinnable-header.vector-main-menu.pin"]' ).click()
				observer.disconnect();
				break;
			}
		}
	});
	
	observer.observe(document.documentElement, { attributes: true, attributeFilter: ['class'] });
}

Pokud chcete nástroje ve výchozím nastavení nastavit i pro anonymní uživatele, můžete přidat následující řádek kódu (za řádek 5):

document.querySelector( '[data-event-name="pinnable-header.vector-page-tools.pin"]' ).click()

Související odkazy

• Projektová dokumentace