Manuel:$wgLogos
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é.) |
Autres paramètres : Alphabétique | Par fonction |
Détails
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. |
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,
],
],
],
];
En fonction des paramètres de votre serveur, l'information concernant l'image est à utiliser, peut être mise sur un serveur de cache. Les images peuvent également rester dans le cache du navigateur web assez longtemps et vous ne voyez pas immédiatement le nouveau logo dès lors que vous modifiez le fichier de l'image. Dans ce cas il serait nécessaire de vider spécialement les caches et de recharger l'URL de l'image dans votre navigateur web pour que le navigateur télécharge la version actuelle à partir du serveur. |
Voir aussi
- Comment modifier le logo ?
- $wgLogo (MediaWiki < 1.35.0)
- $wgLogoHD (MediaWiki < 1.35.0)
- $wgFavicon
- $wgAppleTouchIcon