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 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é.) |
Autres paramètres : Alphabétique | Par fonction |
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,
],
];
Simple example
$wgLogos = [
'icon' => "$wgScriptPath/myCustomLogo.png", // path to icon, the primary logo for Vector
'1x' => "$wgScriptPath/myCustomLogo.png", // path to 1x version
'2x' => "$wgResourceBasePath/hiResLogo.png", // path to 2x version
];
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,
],
],
],
];
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