Jump to content

Manuel:$wgLogos

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

Attention ! Attention : Il ne suffit pas simplement de réécraser le logo par défaut installé dans MediaWiki (/resources/assets/wiki.png); ce fichier sera remplacé quand vous mettrez à jour le logiciel.
Une taille plus grande peut être utilisée 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 affichée et si ce coin est blanc on pourrait penser que l'image ne s'affiche pas.
La taille recommandée d'un logo carré est de 135 × 135 pixels, bien que le logo ne soit pas obligatoirement carré, surtout s'il inclut du texte sous l'image. La taille maximale du logo dans l'habillage Vector est environ de 160 × 160 pixels tandis que dans MonoBook, elle est environ de 155 × 155 pixels.

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 , Habillage: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 , Habillage: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,
	],
];


Exemple simple

$wgLogos = [
	'icon' => "$wgScriptPath/lol.png",			// chemin vers l'icône, le logo primaire pour Vector
	'1x' => "$wgScriptPath/myCustomLogo.png",			// chemin vers la version 1x
	'2x' => "$wgResourceBasePath/hiResLogo.png",		// chemin vers la version 2x
];

Exemple de chemins

$wgLogos = [
	'1x' => "/lol.png",												// chemin relatif vers le fichier dans le dossier du logo, version 1x
	'1.5x' => "https://mywiki.org/w/resources/assets/lol.png",	// chemin dans l'URL entièrement qualifié vers la version 1.5x
	'2x' => "/lol.png",												// chemin relatif à la version 2x, qui commence toujours par une barre oblique
	//  'svg' => "",													// pas svg (obsolète dans MW)
	'icon' => "lol.png",												// Support limité, soit 50x50 pour svg ou 100x100 pour png
	'wordmark' =>  [
		'src' => "/wordmark_sitename.png",								// image de 135 pixels de largeur du texte du nom de site, prise en charge limitée
		'width' => 135,
		'height' => 20,
   ],
	'tagline' => [
        'src' => "/tagline_subtitle.png",								// image de 135 pixels du texte du slogan sans le nom de site
		'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