Руководство:$wgLogos

URL-адреса серверов и пути к файлам: $wgLogos
URL-путь к различным логотипам вики.
Введено в версии:	1.35.0 (Gerrit change 562588; git #8cd2e133)
Удалено в версии:	всё ещё используется
Допустимые значения:	(массив факторов и относительных путей или URL-адресов)
Значение по умолчанию:	false (Note: The default value of this variable depends on other variables, such as the values set in Setup.php , after LocalSettings.php is executed.)
Другие настройки: По алфавиту | По функциональности

This variable in LocalSettings.php specifies the location of one or more files to be used as the site logo. (то есть изображение, отображаемое в левом верхнем углу страницы в большинстве установок MediaWiki).

Массив факторов и связанных с ними относительных путей или URL-адресов к различным версиям логотипа вики.

This replaces $wgLogo , which was used before MediaWiki 1.35 .

Подробности

См. также: How do I change the logo?

Предупреждение:

Не перезаписывайте файл логотипа, установленный по умолчанию с MediaWiki (/resources/assets/wiki.png); этот файл будет перезаписан во время обновления.

The recommended size of a square logo for the legacy Vector skin is 135×135 pixels for a raster image (e.g., PNG) and 50×50 (nominally) for a vector image (SVG), though the logo does not have to be square, especially if it includes text below a picture, like Wikipedia's logo from 2010. The recommended logo size in the newer Vector 2022 skin is 100×100 pixels for raster and 50×50 (nominally) for vector. The maximum logo size in legacy Vector is about 160×160 pixels, while in MonoBook it's about 155×155.

Поддерживаемые варианты

icon

This is used for the site logo in the Vector 2022 skin, where it is shown at 50×50 pixels (or SVG equivalent), and in the Timeless , Refreshed , Citizen skins, where it is typically shown at larger sizes. Обратите внимание, что другие скины обычно требуют более крупного иконки, если они поддерживают это, поэтому вместо этого рекомендуется использовать SVG, поскольку он будет правильно масштабироваться для всех из них. она должна быть квадратной и должна иметь номинальные размеры 50×50 пикселей для SVG, или 100×100 пикселей для растрового, чтобы поддерживать HiDPI. Текущая поддержка этого ключа ограничена $1, но это рекомендуется для всех новых скинов.

1x

This is used by the legacy Vector and MonoBook skins, and some others. она должна быть шириной 135 пикселей и высотой до ~ 155 пикселей. Это связано с тем, что версии 1.5x и 2x предполагают номинальную ширину 135 пикселей, а высота до 155 пикселей без проблем помещается в стандартные скины. Больший размер может быть использован путем изменения CSS сайта, но MediaWiki не изменит размер слишком большого логотипа. Instead, only part of the image (specifically the upper left-hand corner) will be visible, and if this corner is white it may seem like the image is not being displayed at all. Это поддерживает старые скины и в долгосрочной перспективе будет объявлено устаревшим. Мы рекомендуем, чтобы скины поддерживали предпочитаемый `icon`.

1.5x

она должна иметь ширину 202 пикселя, что соответствует соотношению сторон 1x. Ключ будет устаревать, и его использование не рекомендуется.

2x

она должна быть шириной 270 пикселей, что соответствует соотношению сторон 1x. Ключ будет устаревать, и его использование не рекомендуется.

svg

она заменяет версию 1x, 1.5x и 2x, но должна следовать тем же рекомендациям по номинальному размеру, умещаясь в пределах 135 пикселей в ширину и 155 пикселей в высоту при изменении размера до 135 пикселей в ширину. Ключ будет устаревать, и его использование не рекомендуется.

Также есть два необязательных поля для отображения дополнительных ресурсов рядом с логотипом:

wordmark

это должен быть логотип с горизонтальной ориентацией, с максимальной установленной шириной или высотой, как указано в ключах width и height. The width should not exceed 124px and the height should not exceed 32px. Обычно это графическая версия $wgSitename. Это используется в Vector 2022 (1.36), Timeless , Minerva , Citizen

tagline

The requirements here are the same as for the wordmark. то же самое верно и для слогана, который обычно соответствует части MediaWiki:Tagline, не относящейся к названию сайта. The combined height of the tagline and wordmark should not exceed 50px.

Все значения (кроме width и height) могут быть либо полным URL-адресом, либо относительным путем от ll|Manual:Installing MediaWiki#Document root. Если это относительный путь, то он должен начинаться с косой черты (файл в $1 это /file.png, а не file.png).

Example images

Пример

$wgLogos = [
	'1x' => "путь к версии 1x.png",
	'1.5x' => "путь к версии 1.5x.png",
	'2x' => "путь к версии 2x.png",
	'svg' => "путь к версии svg.svg",
	'icon' => "path/to/icon.png",  // Вариант логотипа без надписи и слогана
	'wordmark' => [
		'src' => "путь к версии с надписью.png",
		'1x' => "path/to/wordmark_version.svg",  // по желанию, если вы хотите поддерживать браузеры с поддержкой SVG с SVG-логотипом.
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "путь к версии со слоганом.png",
		'width' => 135,
		'height' => 15,
	],
];

Простой пример

$wgLogos = [
	'icon' => "$wgScriptPath/lol.png",            // path to primary logo for Vector 2022
	'1x' => "$wgScriptPath/myCustomLogo.png",     // путь к версии 1x
	'2x' => "$wgResourceBasePath/hiResLogo.png",  // путь к версии 2x
];

Пример путей

There is no special significance to the choices of whether to use relative file paths or URLs in this example.

$wgLogos = [
	'1x' => "/lol.png",    // relative path to file in document root
	'1.5x' => "https://mywiki.org/w/resources/assets/lol.png",  // full URL to elsewhere
	'2x' => "/lol.png",    // relative paths always start with a slash
	//  'svg' => "",       // svg key has been deprecated
	'icon' => "/lol.png",  // 50×50 SVG or 100×100 PNG (limited support)
	'wordmark' =>  [
		'src' => "/wordmark_sitename.png",  // image of sitename text (limited support)
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "/tagline_subtitle.png",   // image of tagline text without sitename (limited support)
		'width' => 135,
		'height' => 15,
	],
];

Добавление логотипов для вариантов языка

Функциональность для переопределения логотипов для разных языковых вариантов была представлена ​​в версии 1.36.0 (Gerrit change 627939, git #8cd2e133). См. T261153.

При определении вариантов можно использовать любой языковой ключ, например, можно указать немецкий вариант английского логотипа.

Это было распространено на все ключи логотипом в 1.39.0.

$wgLogos = [
	'1x' => "path/to/1x_version.png",      // путь к версии 1x
	'1.5x' => "path/to/1.5x_version.png",  // путь к версии 1.5x
	'2x' => "path/to/2x_version.png",      // путь к версии 2x
	'svg' => "path/to/svg_version.svg",    // путь к версии svg
	'icon' => "path/to/icon.png",          // Вариант логотипа без надписи и слогана
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",  // путь к версии с надписью
		'1x' => "path/to/wordmark_version.svg",   // по желанию, если вы хотите поддерживать браузеры с поддержкой SVG с SVG-логотипом.
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "path/to/tagline_version.png",	  // путь к версии со слоганом
		'width' => 135,
		'height' => 15,
	],
	'variants' => [
		'variant-code' => [
			'1x' => "path/to/language_variant_1x_version.png",      // путь к версии 1x в языковом варианте
			'1.5x' => "path/to/language_variant_1.5x_version.png",  // путь к версии 1.5x в языковом варианте
			'2x' => "path/to/language_variant_2x_version.png",      // путь к версии 2x в языковом варианте
			'svg' => "path/to/language_variant_svg_version.svg",    // путь к версии svg в языковом варианте
			'icon' => "path/to/language_variant_icon.png",          // Вариант логотипа без надписи и слогана в языковом варианте
			'wordmark' => [
				'src' => "path/to/language_variant_wordmark_version.png",  // путь к версии с надписью в языковом варианте
				'1x' => "path/to/language_variant_wordmark_version.svg",   // по желанию, если вы хотите поддерживать браузеры с поддержкой SVG с SVG-логотипом в языковом варианте.
				'width' => 135,
				'height' => 20,
			],
		],
	],
];

Смотрите также

• Как я могу изменить логотип?
• $wgLogo
• $wgFavicon
• $wgAppleTouchIcon