Manuel:$wgLogos

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:$wgLogos and the translation is 30% complete.
Outdated translations are marked like this.
URLs de serveur et chemins de fichiers: $wgLogos
Le chemin d'URL vers différents logos du wiki.
Introduit dans la version :1.35.0 (Gerrit change 562588; git #8cd2e133)
Retiré dans la version :Encore utilisé
Valeurs autorisées :(tableau d'éléments et chemins ou URL 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

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

Formats supportés

  • La version de l'icône doit être un carré et doit être nominalement 50x50 pixels si SVG, ou 100x100 pixels si 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 , mais cela est recommandé pour tous les nouveaux habillages. Notez que les autres skins nécessitent généralement une icône plus grande s'ils le prennent en charge, il est donc recommandé d'utiliser le format SVG à la place car il évoluera correctement sur tous.
  • La version 1x 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 s'adapteront sans problème aux skins standard. This supports older skins and in the long term future will be deprecated. We recommend skins support the preferred `icon`.
  • The 1.5x version should 202px wide, matching the aspect ratio of the 1x.

(so up to 232px tall, for 155px nominal height.) The key will be deprecated in future and its use is not recommended.

  • The 2x version should be 270px wide, matching the aspect ratio of the 1x.

(so up to 310px tall, for 155px nominal height.) The key will be deprecated in future and its use is not recommended.

  • The svg version replaces the need for a 1x, 1.5x, and 2x version, but should follow the same nominal size guidelines, fitting within 135px wide and 155px tall when resized to 135px wide.

The key will be deprecated in future and its use is not recommended.

There are also two optional fields for additional assets to show next to the logo:

  • The wordmark should be a landscape logo, with maximum set width or height, as these are specified under the width and height keys.

Typically this is the graphic version of $wgSitename. This is used Habillage:Vector (1.36), Habillage:Timeless , Skin:Minerva

  • The same is true for the tagline, which typically corresponds to the non-sitename part of MediaWiki:Tagline.

All values (except width and height) can either be a fully-qualified URL or a relative path from DOCUMENT_ROOT. If it's a relative path, it has to start with a slash (a file in DOCUMENT_ROOT is /file.png, not file.png). Instead, the image will be cut off so that only part of it (the upper left-hand corner to be precise) will be visible. If this corner is completely white, it might look like the image would not display although in fact it does.


Example

$wgLogos = [
	'1x' => "path/to/1x_version.png",
	'1.5x' => "path/to/1.5x_version.png",
	'2x' => "path/to/2x_version.png",
	'svg' => "path/to/svg_version.svg",
	'icon' => "path/to/icon.png",  // A version of the logo without wordmark and tagline
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",
		'1x' => "path/to/wordmark_version.svg", // optional if you want to support browsers with SVG support with an SVG logo.
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "path/to/tagline_version.png",
		'width' => 135,
		'height' => 15,
	],
];
Attention! Attention : Do not simply overwrite the default logo installed with MediaWiki (/resources/assets/wiki.png). This file will automatically be overwritten when you upgrade and your changes will be lost.

See also