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 91% 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 .)

Podrobnosti

Pozor! Pozor: Do not simply overwrite the default logo installed within MediaWiki (/resources/assets/wiki.png); this file will be overwritten when you upgrade the software.
A larger size can be used by modifying the site’s CSS, but MediaWiki will not resize a logo that is too large. Instead, only part of the image (specifically the upper left-hand corner) will be displayed, and if this corner is white, it may seem like the image is not displaying.
The recommended size for a square logo is 135 × 135px, though the logo doesn’t have to be square, especially if it includes text below an image. The maximum logo size in the Vector skin is ~160 × 160px, while in MonoBook it’s ~155 × 155px.

Pole s faktory a jejich přidruženými relativními cestami nebo cestami URL k různým verzím loga wiki. (tj. obrázek zobrazený v levém horním rohu stránky ve většině instalací MediaWiki).

Podporované klíče

Verze ikony
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. Doporučuje se však SVG. Současná podpora tohoto klíče je omezena na Vzhled:Vector , Skin:Timeless , Skin:Refreshed , Skin:Citizen , ale toto je doporučeno pro všechny nové vzhledy. 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.
Verze 1x
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ů. To podporuje starší vzhledy a v dlouhodobé budoucnosti bude zastaralé. Doporučujeme, aby vzhledy podporovaly preferovanou "ikonu".
Verze 1,5x
měl by být široký 202 pixelů, což odpovídá poměru stran 1x. měl by být široký 202 pixelů, což odpovídá poměru stran 1x. Klíč bude v budoucnu zastaralý a jeho použití se nedoporučuje.
Verze 2x
měl by být široký 270 pixelů, což odpovídá poměru stran 1x. (takže až 310 pixelů na výšku, pro nominální výšku 155 pixelů.) Klíč bude v budoucnu zastaralý a jeho použití se nedoporučuje.
Verze 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. The width shouldn't exceed 124 and the height shouldn't exceed 32px. Obvykle se jedná o grafickou verzi $wgSitename. Používá se v Vzhled:Vector (1.36), Skin:Timeless , Skin:Minerva , Skin:Citizen .
tagline
Totéž platí pro slogan, který obvykle odpovídá části MediaWiki:Tagline, která není součástí názvu webu. The combined height of the tagline and wordmark should not exceed 50px.

Všechny hodnoty (kromě width a height) mohou být buď plně kvalifikovaná adresa URL, nebo relativní cesta od DOCUMENT_ROOT. Pokud je to relativní cesta, musí začínat lomítkem (soubor v DOCUMENT_ROOT je /file.png, ne file.png). Místo toho bude obrázek oříznut, takže bude viditelná pouze jeho část (přesněji levý horní roh). Pokud je tento roh zcela bílý, může to vypadat, že se obrázek nezobrazí, ačkoli ve skutečnosti ano.

Example images

Příklad

$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,
	],
];


Jednoduchý příklad

$wgLogos = [
	'icon' => "$wgScriptPath/lol.png",			// path to icon, the primary logo for Vector
	'1x' => "$wgScriptPath/myCustomLogo.png",			// cesta k verzi 1x
	'2x' => "$wgResourceBasePath/hiResLogo.png",		// cesta k verzi 2x
];

Příklad cest

$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