Jump to content

Příručka:$wgLogos

From mediawiki.org
This page is a translated version of the page Manual:$wgLogos and the translation is 99% complete.
Adresy URL serveru a cesty k souborům: $wgLogos
Cesta URL k různým logům wiki.
Zavedeno od verze:1.35.0 (Gerrit change 562588; git #8cd2e133)
Odstraněno od verze:stále se používá
Povolené hodnoty:(pole faktorů a relativní cesty nebo adresy URL)
Výchozí hodnota:false
(Poznámka: Výchozí hodnota této proměnné závisí na nastavení dalších proměnných, které nastaví přes Setup.php , poté co se zpracuje skript LocalSettings.php .)

Tato proměnná v proměnné LocalSettings.php určuje umístění jednoho nebo více souborů, které mají být použity jako logo webu. (tj. obrázek zobrazený v levém horním rohu stránky ve většině instalací MediaWiki).

Pole s faktory a jejich přidruženými relativními cestami nebo cestami URL k různým verzím loga wiki.

Toto nahrazuje $wgLogo , které se používalo před MediaWiki 1.35 .

Podrobnosti

Pozor! Pozor: Nepřepisujte pouze výchozí logo nainstalované v MediaWiki (/resources/assets/wiki.png); tento soubor bude při aktualizaci softwaru přepsán.
Doporučená velikost čtvercového loga je 135 × 135 pixelů, ačkoli logo nemusí být čtvercové, zejména pokud obsahuje text pod obrázkem. The recommended logo size in the newer Vector 2022 skin is 100×100 pixels for raster and 50×50 (nominally) for vector. Maximální velikost loga ve vzhledu Vector je ~160 × 160 px, zatímco v MonoBook je to ~155 × 155 px.

Podporované klíče

icon
Toto se používá pro logo webu ve vzhledu Vector 2022 , kde se zobrazuje v rozměru 50×50 pixelů (nebo ekvivalentu SVG), a ve vzhledech Timeless , Refreshed , Citizen , kde se obvykle zobrazuje ve větších rozměrech. Všimněte si, že ostatní vzhledy obvykle vyžadují větší ikonu, pokud to podporují, takže se doporučuje místo toho použít SVG, protože se bude správně škálovat ve všech z nich. měl by to být čtverec a měl by mít nominálně 50 × 50 pixelů, pokud je SVG, nebo 100 × 100 pixelů, pokud je rastrový, aby podporoval HiDPI. Aktuální podpora pro tento klíč je omezena na dříve zmíněné vzhledy, ale jeho podpora se doporučuje pro všechny nové vzhledy.
1x
Toto používají vzhledy legacy Vector a MonoBook a některé další.[potřebné objasnit] měla by být 135 pixelů široká a až ~155 pixelů vysoká. Je to proto, že verze 1,5x a 2x předpokládají nominální šířku 135 pixelů a výška až 155 pixelů se bez problémů vejde do standardních vzhledů.[potřebné objasnit] Větší velikost lze použít úpravou CSS webu, ale MediaWiki nezmění velikost příliš velkého loga. Místo toho se zobrazí pouze část obrázku (konkrétně levý horní roh), a pokud je tento roh bílý, může se zdát, že se obrázek nezobrazuje. To podporuje starší vzhledy a v dlouhodobé budoucnosti bude zastaralé. Doporučujeme, aby vzhledy podporovaly preferovanou "ikonu".
1.5x
Tento obrázek by měl mít šířku 202 pixelů a poměr stran by měl odpovídat obrázku 1x (tedy až 232 pixelů na výšku, pro nominální výšku 155 pixelů). Klíč bude v budoucnu zastaralý a jeho použití se nedoporučuje.
2x
Tento obrázek by měl mít šířku 270 pixelů a poměr stran by měl odpovídat obrázku 1x (tedy maximálně 310 pixelů na výšku, což odpovídá nominální výšce 155 pixelů). Klíč bude v budoucnu zastaralý a jeho použití se nedoporučuje.
svg
nahrazuje potřebu verze 1x, 1,5x a 2x, ale měla by se řídit stejnými pokyny pro nominální velikost, vejde se do 135 pixelů na šířku a 155 pixelů na výšku při změně velikosti na šířku 135 pixelů. Klíč bude v budoucnu zastaralý a jeho použití se nedoporučuje.

Vedle loga jsou také dvě volitelná pole pro další podklady:

wordmark
mělo by to být logo na šířku s maximální nastavenou šířkou nebo výškou, protože ty jsou specifikovány pod tlačítky width a height. Šířka by neměla přesáhnout 124 pixelů a výška by neměla přesáhnout 32 pixelů. Obvykle se jedná o grafickou verzi $wgSitename. Používá se v Vector 2022 (1.36), Timeless , Minerva , Citizen .
tagline
Požadavky jsou zde stejné jako pro slovní ochrannou známku. Obrázek obvykle zobrazuje část stránky MediaWiki:Tagline, která není názvem webu (například "Svobodná encyklopedie"). Kombinovaná výška sloganu a slovního označení by neměla překročit 50 pixelů.

Všechny hodnoty (kromě width a height) mohou být buď plně kvalifikovaná adresa URL, nebo relativní cesta od ll|Manual:Installing MediaWiki#Document root. Pokud je to relativní cesta, musí začínat lomítkem (soubor v $1 je /file.png, ne file.png).

Ukázkové obrázky

Příklad

$wgLogos = [
	'1x' => "cesta k verzi 1x.png",
	'1.5x' => "cesta k verzi 1.5x.png",
	'2x' => "cesta k verzi 2x.png",
	'svg' => "cesta k verzi svg.svg",
	'icon' => "cesta/k/ikoně.png",  // verze loga bez slovního označení a sloganu
	'wordmark' => [
		'src' => "cesta k verzi wordmarku.png",
		'1x' => "cesta/k/verzi_značky_slova.svg",  // volitelné, pokud chcete podporovat prohlížeče s podporou SVG s logem SVG.
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "cesta k verzi s popisem.png",
		'width' => 135,
		'height' => 15,
	],
];

Jednoduchý příklad

$wgLogos = [
	'icon' => "$wgScriptPath/lol.png",            // cesta k ikoně, primární logo pro Vector
	'1x' => "$wgScriptPath/myCustomLogo.png",     // cesta k verzi 1x
	'2x' => "$wgResourceBasePath/hiResLogo.png",  // cesta k verzi 2x
];

Příklad cest

V tomto příkladu není žádný zvláštní význam pro volbu, zda použít relativní cesty k souborům nebo adresy URL.
$wgLogos = [
	'1x' => "/lol.png",    // relativní cesta k souboru ve složce s logem, 1x verze
	'1.5x' => "https://mywiki.org/w/resources/assets/lol.png",  // plně kvalifikovaná cesta URL k verzi 1,5x
	'2x' => "/lol.png",    // relativní cesta k verzi 2x, která vždy začíná lomítkem
	//  'svg' => "",       // no svg (zastaralé MW)
	'icon' => "/lol.png",  // Omezená podpora, buď 50x50 svg nebo 100x100 png
	'wordmark' =>  [
		'src' => "/wordmark_sitename.png",  // 135px široký obrázek textu názvu stránky, omezená podpora
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "/tagline_subtitle.png",   // 135px obrázek na text se sloganem bez názvu stránky
		'width' => 135,
		'height' => 15,
	],
];

Přidání log pro jazykové varianty

Funkce přepisování log pro různé jazykové varianty byla představena ve verzi 1.36.0 (Gerrit change 627939, git #8cd2e133). Podívejte se na stránku T261153.

Při definování variant lze použít libovolný jazykový klíč, např. je možné poskytnout německou variantu anglického loga.

Toto bylo rozšířeno, aby se vztahovalo na všechny klíče loga ve verzi 1.39.0.

$wgLogos = [
	'1x' => "path/to/1x_version.png",      // cesta k verzi 1x
	'1.5x' => "path/to/1.5x_version.png",  // cesta k verzi 1.5x
	'2x' => "path/to/2x_version.png",      // cesta k verzi 2x
	'svg' => "path/to/svg_version.svg",    // cesta k verzi svg
	'icon' => "path/to/icon.png",          // Verze loga bez slovního označení a sloganu
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",  // cesta k verzi wordmarku
		'1x' => "path/to/wordmark_version.svg",   // volitelné, pokud chcete podporovat prohlížeče s podporou SVG s logem SVG.
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "path/to/tagline_version.png",	  // cesta k verzi s popisem
		'width' => 135,
		'height' => 15,
	],
	'variants' => [
		'variant-code' => [
			'1x' => "path/to/language_variant_1x_version.png",      // cesta k verzi 1x v jazykové variantě
			'1.5x' => "path/to/language_variant_1.5x_version.png",  // cesta k verzi 1.5x v jazykové variantě
			'2x' => "path/to/language_variant_2x_version.png",      // cesta k verzi 2x v jazykové variantě
			'svg' => "path/to/language_variant_svg_version.svg",    // cesta k verzi svg v jazykové variantě
			'icon' => "path/to/language_variant_icon.png",          // verze loga bez slovního označení a sloganu v jazykové variantě
			'wordmark' => [
				'src' => "path/to/language_variant_wordmark_version.png",  // cesta k verzi wordmark v jazykové variantě
				'1x' => "path/to/language_variant_wordmark_version.svg",   // volitelné, pokud chcete podporovat prohlížeče s podporou SVG s logem SVG v jazykové variantě.
				'width' => 135,
				'height' => 20,
			],
		],
	],
];

Související odkazy