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 |
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
![]() | Nepřepisujte pouze výchozí logo nainstalované v MediaWiki (/resources/assets/wiki.png ); tento soubor bude při aktualizaci softwaru přepsán. |
![]() | 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. |
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
aheight
. Šíř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
$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
- Jak změním logo?
- $wgLogo (MediaWiki < 1.35.0)
- $wgLogoHD (MediaWiki < 1.35.0)
- $wgFavicon
- $wgAppleTouchIcon