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

From mediawiki.org
This page is a translated version of the page Manual:$wgLogos and the translation is 29% complete.
Outdated translations are marked like this.
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)

Подробности

An array with factors and their associated relative paths or URL paths to the different versions of the wiki logo. (то есть изображение, отображаемое в левом верхнем углу страницы в большинстве установок MediaWiki).

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

  • The icon version should be a square and should be nominally 50×50 pixels if SVG, or 100×100 pixels if raster in order to support HiDPI.

SVG however is recommended. Current support for this key is limited to Тема оформления:Векторное , Тема оформления:Timeless , and Тема:Обновлённость , but this is recommended for all new skins. Note that other skins typically require a larger icon if they support this, so using an SVG instead is recommended as it will scale correctly across all of them.

  • Версия 1.x должна быть квадратной и иметь максимальный размер 135х135 пикселей.

This is because the 1.5x and 2x versions assume a nominal width of 135px, and up to 155px tall will fit without issues in standard skins. This supports older skins and in the long-term future will be deprecated. We recommend skins support the preferred `icon`.

  • Версия 1.5x должна быть квадратной и иметь максимальный размер 202х202 пикселей.

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

  • Версия 2x должна быть квадратной и иметь максимальный размер 270х270 пикселей.

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

  • Версия svg должна быть квадратной.

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 same is true for the tagline, which typically corresponds to the non-sitename part of MediaWiki:Tagline.

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

Пример

$wgLogos = [
	'1x' => "path/to/1x_version.png",		// path to 1x version
	'1.5x' => "path/to/1.5x_version.png",	// path to 1.5x version
	'2x' => "path/to/2x_version.png",		// path to 2x version
	'svg' => "path/to/svg_version.svg",		// path to svg version
	'icon' => "path/to/icon.png",			// A version of the logo without wordmark and tagline
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",	// path to wordmark version
		'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",		// path to tagline version
		'width' => 135,
		'height' => 15,
	],
];

Adding logos for language variants

The functionality to override logos for different language variants was introduced in version 1.36.0 (Gerrit change 627939, git #8cd2e133). See T261153.

When defining variants, any language key can be used, for example it is possible to provide a German variant of an English logo.

This was extended to apply to all logo keys in 1.39.0.

$wgLogos = [
	'1x' => "path/to/1x_version.png",		// path to 1x version
	'1.5x' => "path/to/1.5x_version.png",	// path to 1.5x version
	'2x' => "path/to/2x_version.png",		// path to 2x version
	'svg' => "path/to/svg_version.svg",		// path to svg version
	'icon' => "path/to/icon.png",			// A version of the logo without wordmark and tagline
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",	// path to wordmark version
		'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",		// path to tagline version
		'width' => 135,
		'height' => 15,
	],
	'variants' => [
		'variant-code' => [
			'1x' => "path/to/language_variant_1x_version.png",		// path to 1x version in language variant
			'1.5x' => "path/to/language_variant_1.5x_version.png",	// path to 1.5x version in language variant
			'2x' => "path/to/language_variant_2x_version.png",		// path to 2x version in language variant
			'svg' => "path/to/language_variant_svg_version.svg",	// path to svg version in language variant
			'icon' => "path/to/language_variant_icon.png",			// A version of the logo without wordmark and tagline in language variant
			'wordmark' => [
				'src' => "path/to/language_variant_wordmark_version.png",	// path to wordmark version in language variant
				'1x' => "path/to/language_variant_wordmark_version.svg",	// optional if you want to support browsers with SVG support with an SVG logo in language variant.
				'width' => 135,
				'height' => 20,
			],
		],
	],
];
Осторожно! Предупреждение: Не делайте простую перезапись логотипа по умолчанию, установленного с MediaWiki (/resources/assets/wiki.png). Этот файл будет автоматически перезаписан при обновлении, и ваши изменения будут потеряны.


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