Jump to content

Manual:$wgLogos

From mediawiki.org
This page is a translated version of the page Manual:$wgLogos and the translation is 100% complete.
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)

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

Let op! Let op: 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.
Het aanbevolen formaat voor een vierkant logo is 135x135px, maar het logo hoeft geen vierkant te zijn, zeker niet als er tekst onder de afbeelding staat. De aanbevolen grootte van het logo in de skin Vector 2022 is 100×100 pixels voor raster en 50×50 (nominaal) voor vector. De maximale logo grootte in de skin Vector is ~160 × 160px, terwijl het in MonoBook ~155 × 155px is.

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 icon van 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 width en height. 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

Er is geen speciale betekenis aan de keuzes om relatieve bestandspaden of URL's in dit voorbeeld te gebruiken.
$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,
			],
		],
	],
];

Zie ook