Manuel:$wgLogos

URLs de serveur et chemins de fichiers: $wgLogos
URLs et chemins des fichiers vers différents logos de wiki.
Introduit dans la version :	1.35.0 (Gerrit change 562588; git #8cd2e133)
Retiré dans la version :	Encore utilisé
Valeurs autorisées :	(tableau des clés et des chemins relatifs associés ou des URLs)
Valeur par défaut :	false (Note : La valeur par défaut de cette variable dépend d'autres variables, comme les valeurs intitialisées dans Setup.php , après que LocalSettings.php ait été exécuté.)
Autres paramètres : Alphabétique | Par fonction

Cette variable dans LocalSettings.php spécifie l'emplacement d'un ou plusieurs fichiers à utiliser pour le logo du site. (l'image affichée dans le coin supérieur gauche de chaque page dans la plupart des installations MediaWiki).

La valeur est un tableau associatif avec les clés et les chemins relatifs vers les fichiers correspondants ou les URLs vers diverses versions du logo du wiki.

Ceci remplace $wgLogo , qui a été utilisé avant MediaWiki 1.35 .

Détails

Voir aussi : Comment modifier le logo ?

Attention :

Il ne suffit pas simplement de réécraser le logo par défaut installé de MediaWiki (/resources/assets/wiki.png); ce fichier sera remplacé quand vous mettrez à jour le logiciel.

La taille recommandée d'un logo carré pour l'ancien habillage Vector est de 135×135 pixels pour une image matricielle (comme PNG) et 50×50 pixels (valeurs nominatives) pour une image vectorielle (comme SVG), bien que le logo ne soit pas obligatoirement carré, surtout s'il inclut du texte sous l'image, comme le logo Wikipedia de 2010. The recommended logo size in the newer Vector 2022 skin is 100×100 pixels for raster and 50×50 (nominally) for vector. La taille maximale du logo dans l'habillage ancien Vector est environ de 160×160 pixels tandis que dansMonoBook , elle est environ de 155×155 pixels.

Clés supportées

icon

Ceci est utilisé pour le logo du site dans l'habillage Vector 2022 où il apparaît en 50×50 pixels (ou équivalent SVG), et dans les habillages Timeless , Refreshed , Citizen avec des tailles plus grandes. Il est recommandé d'utiliser le format SVG car il redimensionnera correctement tous les cas. Sinon l'icône doit être un carré de 100×100 pixels si l'image est matricielle (comme le PNG) afin de prendre en charge HiDPI. La prise en charge actuelle de cette clé est limitée aux habillages mentionnés précédemment, et il est recommandé de la supporter pour tous les nouveaux habillages.

1x

Ceci est utilisé par les habillages legacy Vector , MonoBook et quelques autres. L'image doit mesurer 135 pixels de large sur environ 155 pixels de haut. En effet, les versions 1.5x et 2x supposent une largeur nominale de 135px, et jusqu'à 155px de hauteur; elles s'adapteront sans problème aux habillages standard. Un logo de taille plus grande peut être utilisé en modifiant le CSS du site, mais MediaWiki ne redimensionnera pas un logo trop grand. Au lieu de cela, seule une partie de l'image (en particulier le coin supérieur gauche) sera visible et si ce coin est blanc on pourrait penser que l'image ne s'affiche pas du tout. Cette clé et encore utilisée par les habillages plus anciens mais deviendra obsolète dans le futur. Nous recommandons aux habillages de prendre en charge la clé préférée icon.

1.5x

La largeur de cette image doit être de 202 pixels et présenter le même ratio que l'image de la version 1.x (soit jusqu'à 232 pixels pour la taille, et 155 pixels pour la hauteur nominale). Comme pour 1x, la clé deviendra obsolète dans le futur, donc son utilisation n'est pas recommandée.

2x

Cette image doit avoir 270 pixels de large et respecter le ratio de la version 1.x (soit jusqu'à 310 pixels pour la taille, et 155 pixels pour la hauteur nominale). Comme pour 1x, ceci deviendra obsolète dans le futur, donc son utilisation n'est pas recommandée.

svg

Ceci est utilisé pour les logos SVG au lieu des clés séparées 1x, 1.5x, 2x mais doit suivre les mêmes règles que ces clés concernant les tailles (nominales), c'est à dire une largeur inférieure à 135px et une hauteur inférieure à 155px quand le redimensionnement est fait sur 135px de largeur. Cette clé deviendra obsolète dans le futur et son utilisation n'est pas recommandée.

Il existe aussi deux champs facultatifs pour les ressources supplémentaires à afficher à la suite du logo :

wordmark

Ceci doit être une image au format 'paysage' (plus large que haute) et ne pas dépasser la largeur et la hauteur maximale définies respectivement par les clés width et height. La largeur ne doit pas dépasser 124 pixels et la hauteur 32 pixels. Typiquement, il s'agit de la version graphique du texte de $wgSitename (par exemple, Wikipedia). Ceci est utilisé dans Vector 2022 (1.36+), Timeless , Minerva , Citizen et les habillages Citizen .

tagline

Les contraintes sont les mêmes que pour les marques. L'image décrit typiquement la partie qui ne contient pas le nom du site de MediaWiki:Tagline (par exemple, The Free Encyclopedia). La hauteur combinée du slogan et de la marque ne doivent pas dépasser 50 pixels.

Toutes les valeurs (sauf width et height) peuvent être soit une URL complètement spécifiée, soit un chemin relatif à partir de la racine du document (c'est à dire le répertoire où MediaWiki a été installé ). Si c'est un chemin relatif, il doit commencer par une barre oblique / (par exemple un fichier de la racine des documents $1 s'écrit /file.png, et non pas file.png).

Exemples d'images

Exemple

$wgLogos = [
	'1x' => "chemin/de la/version 1x.png",
	'1.5x' => "chemin/de la version 1.5x.png",
	'2x' => "chemin/de la/version 2x.png",
	'svg' => "chemin/de la /version svg.svg",
	'icon' => "chemin/vers/icône.png",  // version du logo sans marque ni slogan
	'wordmark' => [
		'src' => "chemin/de/la version du logo de la marque.png",
		'1x' => "chemin/de/la version du logo de la marque.svg",  // optionnel : prise en charge de SVG en plus de PNG
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "chemin/de la /version du slogan.png",
		'width' => 135,
		'height' => 15,
	],
];

Exemple simple

$wgLogos = [
	'icon' => "$wgScriptPath/lol.png",            // chemin vers le logo principal pour Vector 2022
	'1x' => "$wgScriptPath/myCustomLogo.png",     // chemin vers la version 1x pour les autres habillages
	'2x' => "$wgResourceBasePath/hiResLogo.png",  // chemin vers la version 2x pour les autres habillages
];

Exemple de chemins

Dans cet exemple, il n'y a pas de différence sur le choix d'utiliser des chemins relatifs pour les fichiers ou des URLs.

$wgLogos = [
	'1x' => "/lol.png",    // chemin relatif vers le fichier dans la racine des documents
	'1.5x' => "https://mywiki.org/w/resources/assets/lol.png",  // URL complète pointant ailleurs
	'2x' => "/lol.png",    // chemin relatif commençant toujours par une barre oblique
	//  'svg' => "",       // la clé svg est obsolète
	'icon' => "/lol.png",  // 50×50 pour SVG ou 100×100 pour PNG (support limité)
	'wordmark' =>  [
		'src' => "/wordmark_sitename.png",  // image du texte du nom de site (prise en charge limitée)
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "/tagline_subtitle.png",   // image du texte du slogan sans le nom de site (support limité)
		'width' => 135,
		'height' => 15,
	],
];

Ajouter des logos pour les variantes de langue

La fonctionnalité pour réécraser le logo en fonction de la variante de langue a été introduite dans la version 1.36.0 (Gerrit change 627939, git #8cd2e133). Voir T261153.

Quand vous définissez les variantes, vous pouvez utiliser toute langue de votre choix , par exemple vous pouvez fournir une variante allemande pour un logo anglais.

Ceci a été étendu pour s'appliquer à toutes les clés du logo, en 1.39.0.

$wgLogos = [
	'1x' => "path/to/1x_version.png",      // chemin de la version 1x
	'1.5x' => "path/to/1.5x_version.png",  // chemin de la version 1.5x
	'2x' => "path/to/2x_version.png",      // chemin de la version 2x
	'svg' => "path/to/svg_version.svg",    // chemin de la version svg
	'icon' => "path/to/icon.png",          // version du logo sans marque ni slogan
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",  // chemin de la version de la marque
		'1x' => "path/to/wordmark_version.svg",   // optionnel pour un logo SVG si vous souhaitez prendre en charge les navigateurs reconnaissant le SVG.
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "path/to/tagline_version.png",	  // chemin de la version du slogan
		'width' => 135,
		'height' => 15,
	],
	'variants' => [
		'variant-code' => [
			'1x' => "path/to/language_variant_1x_version.png",      // chemin de la version 1x dans la variante de langue
			'1.5x' => "path/to/language_variant_1.5x_version.png",  // chemin de la version 1.5x dans la variante de langue
			'2x' => "path/to/language_variant_2x_version.png",      // chemin de la version 2x dans la variante de langue
			'svg' => "path/to/language_variant_svg_version.svg",    // chemin de la version svg dans la variante de langue
			'icon' => "path/to/language_variant_icon.png",          // version du logo sans marque ni slogan dans la variante de langue
			'wordmark' => [
				'src' => "path/to/language_variant_wordmark_version.png",  // chemin de la version du logo de marque dans la variante de langue
				'1x' => "path/to/language_variant_wordmark_version.svg",   // optionnel pour un logo SVG dans la variante de langue  si vous souhaitez prendre en charge les navigateurs reconnaissant le SVG.
				'width' => 135,
				'height' => 20,
			],
		],
	],
];

Voir aussi

• Comment modifier le logo ?
• $wgLogo (MediaWiki < 1.35.0)
• $wgLogoHD (MediaWiki < 1.35.0)
• $wgFavicon
• $wgAppleTouchIcon