Manuel:$wgLogos

From mediawiki.org
This page is a translated version of the page Manual:$wgLogos and the translation is 90% complete.
URLs de serveur et chemins de fichiers: $wgLogos
Chemin des URLs 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 de facteurs et de chemins ou URLs relatifs.)
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é.)

Détails

C'est un tableau de facteurs avec leurs chemins relatifs associés ou les URLs vers les différentes versions du logo du wiki. (c'est-à-dire l'image affichée dans le coin supérieur gauche de la page dans la plupart des installations MediaWiki).

Clés supportées

La version de l'icône
L'icône doit être un carré, nominalement de 50x50 pixels en format SVG, ou 100x100 pixels si c'est du raster afin de prendre en charge HiDPI. Le format SVG est cependant recommandé. La prise en charge actuelle de cette clé est limitée à Habillage:Vector , Habillage:Timeless , Habillage:Refreshed , Skin:Citizen , et ceci est recommandé pour tous les nouveaux habillages. Notez que les autres habillages nécessitent généralement une icône plus grande s'ils la prennent en charge, il est donc recommandé d'utiliser le format SVG à la place car il évoluera correctement pour tous.
Version 1x
L'icône 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. Ceci prend en charge les habillages plus anciens et deviendra obsolète dans le futur. Nous recommandons aux habillages de prendre en charge l'icône préférée.
Version 1.5x
La largeur doit être de 202 pixels et présenter le même ratio que la version 1.x (donc jusqu'à une taille de 232 pixels, pour une hauteur nominale de 155 pixels). La clé deviendra obsolète dans le futur et son utilisation n'est pas recommandée.
Version 2x
Elle doit avoir 270 pixels de large et respecter le ratio de la 1x. (donc jusqu'à une taille de 310 pixels, pour une hauteur nominale de 155 pixels). La clé deviendra obsolète dans le futur et son utilisation n'est pas recommandée.
Version svg
Remplace la nécessité pour une version 1x, 1.5x, et 2x, et doit suivre les mêmes règles 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. La 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
Ce logo doit être au format 'paysage' et ne pas dépasser la largeur (clé width) ni la hauteur (clé height) maximale. The width shouldn't exceed 124 and the height shouldn't exceed 32px. Typiquement, il s'agit de la version graphique de $wgSitename. Ceci est utilisé dans Habillage:Vector (1.36), Habillage:Timeless , Skin:Minerva , Skin:Citizen
tagline
La même chose est vraie pour le slogan, qui typiquement correspond à la partie qui ne contient pas le nom du site de MediaWiki:Tagline. The combined height of the tagline and wordmark should not exceed 50px.

Toutes les valeurs (sauf width et height) peuvent être soit une URL complètement spécifiée, soit un chemin relatif à partir de DOCUMENT_ROOT. Si c'est un chemin relatif, il doit commencer par une barre oblique / (un fichier de DOCUMENT_ROOT s'écrit /file.png, et non pas file.png). A la place, l'image sera tronquée de sorte qu'uniquement une partie sera visible (précisément le coin supérieur gauche). Si ce coin apparaît complètement blanc, on pourrait penser que l'image n'est pas affichée, mais en réalité elle l'est.

Example images

Exemple

$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 du logo 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,
	],
];

Example paths

$wgLogos = [
	'1x' => "/logo_1x.png",		// relative path to file in logo folder, 1x version
	'1.5x' => "https://mywiki.org/w/resources/assets/logo_1.5x.png",	// fully qualified URL path to 1.5x version
	'2x' => "/logo_2x.png",		// relative path to 2x version, which always starts with a slash
	//  'svg' => "",		// no svg (deprecated by MW)
	'icon' => "icon.png",			// Limited support, either 50x50 svg or 100x100 png
	'wordmark' =>  [
		'src' => "/wordmark_sitename.png",	// 135px wide image of sitename text, limited support
		'width' => 135,
		'height' => 20,
   ],
	'tagline' => [
         'src' => "/tagline_subtitle.png",		// 135px image to tagline text without sitename
		'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,
			],
		],
	],
];
Attention ! Attention : Ne réécrasez pas simplement le logo par défaut installé avec MediaWiki (/resources/assets/wiki.png). Ce fichier sera automatiquement redéfini lors de la prochaine mise à jour et vos modifications seront perdues.

Voir aussi