Příručka:$wgLogos
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 .) |
Další nastavení: Podle abecedy | Podle funkce |
Podrobnosti
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. |
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
aheight
. 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,
],
],
],
];
V závislosti na nastavení vašeho serveru mohou být informace o tom, který obrázek použít, uloženy do mezipaměti serveru. Obrázky mohou být také uloženy v mezipaměti webového prohlížeče po dlouhou dobu, takže nové logo okamžitě neuvidíte, pokud změníte příslušný soubor obrázku. V tomto případě může být nutné zejména vyprázdnit mezipaměť a znovu načíst URL obrázku ve vašem webovém prohlížeči, aby prohlížeč stáhl aktuální verzi ze serveru. |
Související odkazy
- Jak změním logo?
- $wgLogo (MediaWiki < 1.35.0)
- $wgLogoHD (MediaWiki < 1.35.0)
- $wgFavicon
- $wgAppleTouchIcon