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

From mediawiki.org
This page is a translated version of the page Manual:$wgLogos and the translation is 88% complete.
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)

Подробности

Массив факторов и связанных с ними относительных путей или URL-адресов к различным версиям логотипа вики. (то есть изображение, отображаемое в левом верхнем углу страницы в большинстве установок MediaWiki).

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

Версия иконки
она должна быть квадратной и должна иметь номинальные размеры 50×50 пикселей для SVG, или 100×100 пикселей для растрового, чтобы поддерживать HiDPI. Однако рекомендуется SVG. Текущая поддержка этого ключа ограничена Тема оформления:Векторное , Тема оформления:Timeless , Тема:Refreshed , Skin:Citizen , но это рекомендуется для всех новых скинов. Обратите внимание, что другие скины обычно требуют более крупного иконки, если они поддерживают это, поэтому вместо этого рекомендуется использовать SVG, поскольку он будет правильно масштабироваться для всех из них.
Версия 1x
она должна быть шириной 135 пикселей и высотой до ~ 155 пикселей. Это связано с тем, что версии 1.5x и 2x предполагают номинальную ширину 135 пикселей, а высота до 155 пикселей без проблем помещается в стандартные скины. Это поддерживает старые скины и в долгосрочной перспективе будет объявлено устаревшим. Мы рекомендуем, чтобы скины поддерживали предпочитаемый `icon`.
Версия 1.5x
она должна иметь ширину 202 пикселя, что соответствует соотношению сторон 1x. (вплоть до 232 пикселей в высоту для номинальной высоты 155 пикселей.) Ключ будет устаревать, и его использование не рекомендуется.
Версия 2x
она должна быть шириной 270 пикселей, что соответствует соотношению сторон 1x. (вплоть до 310 пикселей в высоту для номинальной высоты 155 пикселей.) Ключ будет устаревать, и его использование не рекомендуется.
Версия svg
она заменяет версию 1x, 1.5x и 2x, но должна следовать тем же рекомендациям по номинальному размеру, умещаясь в пределах 135 пикселей в ширину и 155 пикселей в высоту при изменении размера до 135 пикселей в ширину. Ключ будет устаревать, и его использование не рекомендуется.

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

wordmark
это должен быть логотип с горизонтальной ориентацией, с максимальной установленной шириной или высотой, как указано в ключах width и height. The width shouldn't exceed 124 and the height shouldn't exceed 32px. Обычно это графическая версия $wgSitename. Это используется в Тема оформления:Векторное (1.36), Тема оформления:Timeless , Skin:Minerva , Skin:Citizen
tagline
то же самое верно и для слогана, который обычно соответствует части MediaWiki:Tagline, не относящейся к названию сайта. The combined height of the tagline and wordmark should not exceed 50px.

Все значения (кроме width и height) могут быть либо полным URL-адресом, либо относительным путем от DOCUMENT_ROOT. Если это относительный путь, то он должен начинаться с косой черты (файл в DOCUMENT_ROOT это /file.png, а не file.png). Вместо этого изображение будет обрезано так, что будет видна только его часть (точнее, верхний левый угол). Если этот угол полностью белый, то может показаться, что изображение не отображается, хотя на самом деле это не так.

Example images

Пример

$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,
	],
];


Simple example

$wgLogos = [
	'1x' => "$wgScriptPath/myCustomLogo.png",			// path to 1x version
	'2x' => "$wgResourceBasePath/hiResLogo.png",		// path to 2x version
];

Пример путей

$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,
	],
];

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

Функциональность для переопределения логотипов для разных языковых вариантов была представлена ​​в версии 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,
			],
		],
	],
];
Осторожно! Предупреждение: Не делайте простую перезапись логотипа по умолчанию, установленного с MediaWiki (/resources/assets/wiki.png). Этот файл будет автоматически перезаписан при обновлении, и ваши изменения будут потеряны.


См. также