Manual:$wgLogos
| Server URL's en bestandspaden: $wgLogos | |
|---|---|
| Het URL-pad naar verschillende wiki-logo's. |
|
| Geïntroduceerd in versie: | 1.35.0 (Gerrit change 562588; git #8cd2e133) |
| Verwijderd in versie: | nog steeds in gebruik |
| Toegelaten waardes: | (array van factors en relatieve paden of url's) |
| Standaardwaarde: | false(Opmerking: De standaard waarde van deze variabele hangt af van andere variabelen, zoals de waardes ingesteld in Setup.php, nadat LocalSettings.php is uitgevoerd) |
| Andere instellingen: Alfabetisch | Per functie | |
Deze variabele in LocalSettings.php geeft de locatie aan van een of meer bestanden die als sitelogo moeten worden gebruikt. Het sitelogo is een standaard interface-element in de meeste MediaWiki skins en is het meest herkenbaar als de afbeelding die linksboven op elke pagina wordt weergegeven.
Een array met factoren en de bijbehorende relatieve paden of URL-paden naar de verschillende versies van het wiki-logo.
Dit vervangt $wgLogo , die vóór MediaWiki 1.35 werd gebruikt.
Details
Overschrijf niet simpelweg het standaardlogo dat met MediaWiki is geïnstalleerd (/resources/assets/wiki.png); dat bestand wordt bij een upgrade van de software weer overschreven. |
Afhankelijk van uw serverinstellingen kan de informatie over welke afbeelding gebruikt moet worden in een servercache worden gecached. Ook kunnen afbeeldingen lange tijd in de cache van de webbrowser worden opgeslagen, zodat u het nieuwe logo niet meteen ziet als u het bijbehorende afbeeldingsbestand hebt gewijzigd. In dit geval kan het nodig zijn om vooral de caches te legen en de URL van de afbeelding opnieuw te laden in uw webbrowser, zodat de browser de huidige versie van de server downloadt. |
Ondersteunde keys
- icon
- Dit wordt gebruikt voor het sitelogo in de skin Vector 2022, waar het wordt weergegeven op 50×50 pixels (of SVG-equivalent), en in de skins Timeless, Refreshed, Citizen, waar het meestal op grotere formaten wordt weergegeven. Andere skins eisen meestal een grote icoon als ze dit ondersteunen, dus het in plaats daarvan gebruiken van een SVG wordt aanbevolen vanwege de goede schaalbaarheid. Dit moet een vierkant zijn en zal meestal 50x50 pixels zijn indien het SVG is, of 100×100 pixels indien het een raster is om
HiDPI te ondersteunen. De huidig ondersteuning hiervan is beperkt tot de eerder genoemd skins, maar het ondersteunen wordt voor alle nieuwe skins aanbevolen.
- 1x
- Dit wordt gebruikt door de skins legacy Vector en MonoBook en enkele andere.[verduidelijking nodig] Dit moet een rechthoek van 135 pixels breed en tot 155 pixels hoog zijn. Dit is omdat de 1.5x en 2x versies een nominale wijdte van 135px en tot 155px hoog aannemen, is het geschikt zonder problemen in de standaard skins.[verduidelijking nodig] Een groter formaat kan worden gebruikt door de CSS van de site aan te passen, maar MediaWiki zal het formaat van een te groot logo niet wijzigen. In plaats daarvan wordt slechts een deel van het beeld (met name de linkerbovenhoek) weergegeven, en als deze hoek leeg is, lijkt het misschien alsof het beeld niet wordt weergegeven. Dit ondersteunt oudere skins en op de langere termijn zal de functie ontraden worden. Wij bevelen skins aan die het
iconvan de voorkeur ondersteunen. - 1.5x
- Deze afbeelding moet 202 pixels breed zijn, overeenkomen met de verhouding van 1x afbeelding (dus tot 232px hoog, voor 155px nominale hoogte).. De sleutel wordt in de toekomst ontraden, het gebruik wordt niet aanbevolen.
- 2x
- Deze afbeelding moet 270px breed zijn en overeenkomen met de verhouding van de 1x-afbeelding (dus maximaal 310px hoog, voor 155px nominale hoogte). De sleutel wordt in de toekomst ontraden, het gebruik wordt niet aanbevolen.
- svg
- Dit vervangt de noodzaak van een 1x, 1.5x en 2x versie, maar moet dezelfde richtlijnen volgen, passend in 135px breed en 155px hoog, wanneer van formaat gewijzigd naar 135px breed. De sleutel wordt in de toekomst ontraden, het gebruik wordt niet aanbevolen.
Er zijn ook twee optionele velden voor het tonen van extra delen naast het logo:
- wordmark
- Dit moet een liggend logo zijn, met een maximale ingestelde breedte of hoogte, zoals deze zijn gespecificeerd onder de
widthenheight. De breedte mag niet groter zijn dan 124px en de hoogte mag niet groter zijn dan 32px. Meestal is die de grafische versie van $wgSitename. Dit wordt gebruikt in Vector 2022 (1.36), Timeless, Minerva en Citizen - tagline
- De vereisten hier zijn hetzelfde als voor het woordmerk. De afbeelding die meestal overeenkomt met het niet websitenaam gedeelte van MediaWiki:Tagline (bijvoorbeeld "The Free Encyclopedia"). De gecombineerde hoogte van de slogan (tagline) en het woordmerk (wordmark) mag niet hoger zijn dan 50 pixels.
Alle waarden (behalve width en height) kunnen een volledig gekwalificeerde URL zijn of een relatief pad vanaf ll|Manual:Installing MediaWiki#Document root.
Als het een relatief pad is, moet het beginnen met een schuine streep (een bestand in $1 is /file.png, niet file.png).
Voorbeeld afbeeldingen
Voorbeeld
$wgLogos = [
'1x' => "pad naar 1x versie.png",
'1.5x' => "pad naar 1.5x versie.png",
'2x' => "pad naar 2x versie.png",
'svg' => "pad naar svg versie.svg",
'icon' => "path/to/icon.png", // Een versie van het logo zonder woordmerk en slogan (tagline)
'wordmark' => [
'src' => "pad naar woordmerk versie.png",
'1x' => "path/to/wordmark_version.svg", // optioneel als u webbrowsers wilt ondersteunen die SVG ondersteunen met een SVG logo.
'width' => 135,
'height' => 20,
],
'tagline' => [
'src' => "pad naar slogan versie.png",
'width' => 135,
'height' => 15,
],
];
Eenvoudig voorbeeld
$wgLogos = [
'icon' => "$wgScriptPath/lol.png", // pad naar icon, het primaire logo voor Vector
'1x' => "$wgScriptPath/myCustomLogo.png", // pad naar 1x versie
'2x' => "$wgResourceBasePath/hiResLogo.png", // pad naar 2x versie
];
Voorbeelden paden
$wgLogos = [
'1x' => "/lol.png", // relatief pad naar bestand in map logo, versie 1x
'1.5x' => "https://mywiki.org/w/resources/assets/lol.png", // volledig URl-pad voor de versie 1.5x
'2x' => "/lol.png", // relatief pad in versie 2x, begint altijd met een slash
// 'svg' => "", // geen svg (ontraden door MediaWiki)
'icon' => "/lol.png", // Beperkte ondersteuning, 50x50 svg of 100x100 png
'wordmark' => [
'src' => "/wordmark_sitename.png", // 135px brede afbeelding van tekst sitenaam, beperkte ondersteuning
'width' => 135,
'height' => 20,
],
'tagline' => [
'src' => "/tagline_subtitle.png", // 135px afbeelding naar tag tekstregel zonder sitenaam
'width' => 135,
'height' => 15,
],
];
Logo's toevoegen voor taalvarianten
De functionaliteit op logo's te overschrijven voor andere taalvarianten is toegevoegd in versie 1.36.0 (Gerrit change 627939, git #8cd2e133). Zie T261153.
Bij het definiëren van varianten kan elke taalsleutel worden gebruikt. Men bijvoorbeeld een Duitse variant hebben van een Engels logo.
Dit is in 1.39.0 uitgebreid zodat het voor alle logo sleutels van toepassing is.
$wgLogos = [
'1x' => "path/to/1x_version.png", // pad naar 1x versie
'1.5x' => "path/to/1.5x_version.png", // pad naar 1.5x versie
'2x' => "path/to/2x_version.png", // pad naar 2x versie
'svg' => "path/to/svg_version.svg", // pad naar svg versie
'icon' => "path/to/icon.png", // Een versie van het logo zonder woordmerk en slogan (tagline)
'wordmark' => [
'src' => "path/to/wordmark_version.png", // pad naar woordmerk versie
'1x' => "path/to/wordmark_version.svg", // optioneel als u webbrowsers wilt ondersteunen die SVG ondersteunen met een SVG logo.
'width' => 135,
'height' => 20,
],
'tagline' => [
'src' => "path/to/tagline_version.png", // pad naar slogan versie
'width' => 135,
'height' => 15,
],
'variants' => [
'variant-code' => [
'1x' => "path/to/language_variant_1x_version.png", // pad naar 1x versie in taalvariant
'1.5x' => "path/to/language_variant_1.5x_version.png", // pad naar 1.5x versie in taalvariant
'2x' => "path/to/language_variant_2x_version.png", // pad naar 2x versie in taalvariant
'svg' => "path/to/language_variant_svg_version.svg", // pad naar svg versie in taalvariant
'icon' => "path/to/language_variant_icon.png", // Een versie van het logo zonder woordmerk en slogan in een taalvariant
'wordmark' => [
'src' => "path/to/language_variant_wordmark_version.png", // pad naar woordmerk versie in taalvariant
'1x' => "path/to/language_variant_wordmark_version.svg", // optioneel als u webbrowsers wilt ondersteunen die SVG ondersteunen met een SVG logo in een taalvariant.
'width' => 135,
'height' => 20,
],
],
],
];