Jump to content

手册：$wgLogos

From mediawiki.org
This page is a translated version of the page Manual:$wgLogos and the translation is 96% complete.
Outdated translations are marked like this.
Languages:
服务器URL及文件路徑: $wgLogos
各种 wiki 标志（logo）的 URL 或文件路径。
引进版本：1.35.0​（Gerrit change 562588; git #8cd2e133）
移除版本：仍在使用
允许的值：(一个数组，其中每个键代表一种 logo 类型，每个键对应的值是该 logo 的相对路径或 URL。)
默认值：false
（注： 此变量的默认值取决于其他变量，例如执行LocalSettings.php 后在Setup.php 中设置的值）
其他设置： 按首字母排序 | 按功能排序

在 LocalSettings.php 中，这个变量用来指定一个或多个作为站点 logo 的文件位置。 （在大多数 MediaWiki 安装中，就是显示在每个页面左上角的图像。）

它的值是一个关联数组，其中的键表示不同版本的 wiki logo，每个键对应的值是相应的文件路径（相对路径）或 URL。

这个变量取代了 $wgLogo ，后者在 MediaWiki 1.35 之前使用。

详情

参见：​如何更改 wiki 的标志？
小心！ 小心： 不要直接覆盖 MediaWiki 安装时自带的那个默认标志 (/resources/assets/wiki.png); 因为当您升级 MediaWiki 时，它会再次被自动覆盖。
在旧版 Vector 皮肤 中，推荐的方形 logo 尺寸是：135×135 像素（适用于位图，如 PNG）和 50×50 像素（适用于矢量图，如 SVG）。不过，logo 并不一定非要是正方形，尤其是在图像下方带有文字的情况下（例如 2010 年的维基百科 logo）。 The recommended logo size in the newer Vector 2022 skin is 100×100 pixels for raster and 50×50 (nominally) for vector. 在旧版 Vector 皮肤中，logo 标志的最大尺寸建议为 160×160 像素。而在 MonoBook 皮肤中，建议设为 155×155像素。

可用的键名

icon
用于 Vector 2022 皮肤的站点 logo，显示为 50×50 像素（或等效的 SVG），在 Timeless , Refreshed , Citizen 皮肤中则通常显示得更大。 推荐使用 SVG，因为它能在不同皮肤下正确缩放。 否则，如果使用 PNG 等位图图像，应该是正方形并为 100×100 像素，以支持 HiDPI 显示。 目前对该键的支持仅限于上述皮肤，但建议所有新皮肤都支持它。
1x
用于 legacy Vector 和 MonoBook 皮肤以及部分其他皮肤。[需要澄清] 图像应为 135px 宽，高度最多约 155px。 这是因为 1.5x 和 2x 版本都假设基准宽度为 135px，而高度最多 155px 在标准皮肤中不会有问题。[需要澄清] 可以通过修改站点 CSS 使用更大尺寸的 logo，但 MediaWiki 不会自动缩小过大的 logo， 只会显示图像的一部分（尤其是左上角）。如果左上角是白色，看起来就像没有显示任何图像一样。 该键仍然被旧皮肤使用，但未来会弃用。 建议皮肤支持更推荐的 icon 键。
1.5x
图像宽度应为 202px，并保持与 1x 图像一致的宽高比（即最高可到 232px，基于 1x 的 155px 标称高度）。 与 1x 一样，该键未来会被弃用，因此不推荐继续使用。
2x
图像宽度应为 270px，并保持与 1x 一致的宽高比（最高可到 310px，基于 1x 的 155px 标称高度）。 与 1x 一样，该键未来会被弃用，因此不推荐使用。
svg
用于替代 1x, 1.5x, 2x 的 SVG logo，但尺寸指南（标称值）应与这些键一致，即在宽度为 135px 时适配在 135px 宽 × 155px 高 的范围内。 该键未来也会被弃用，因此不推荐使用。

此外，还有两个可选字段用于显示在标志旁边以展示额外的图像资源：

wordmark
应为横向图像（宽度大于高度），最大宽度和高度由 width 与 height 键设定。 宽度不能超过 124px，高度不能超过 32px。 通常是 $wgSitename 文本的图形化版本（例如 “Wikipedia”）。 它用于 Vector 2022 (1.36+)、Timeless 、Minerva 和 Citizen 皮肤。
tagline
要求与 wordmark（文字标识）相同。 通常是 MediaWiki:Tagline 中非站点名部分的图形化版本（例如 “The Free Encyclopedia”）。 wordmark（文字标识）与 tagline（标语）的组合高度不应超过 50px。

所有值（除了 width 和 height）都可以是完整的 URL，或者是从文档根目录 开始的相对路径（即 MediaWiki 安装目录 ）。 如果是相对路径，必须以斜杠 / 开头（例如：根目录下的文件应写成 /file.png，而不是 file.png）。

示例图片

示例代码

$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",  // 不包含 wordmark（文字标识）和 tagline（标语）的 logo
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",
		'1x' => "path/to/wordmark_version.svg",  // 除了 PNG，还支持 SVG 格式
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "path/to/tagline_version.png",
		'width' => 135,
		'height' => 15,
	],
];

简易示例

$wgLogos = [
	'icon' => "$wgScriptPath/lol.png",            // 适配 Vector 2022 皮肤的主要 logo 路径
	'1x' => "$wgScriptPath/myCustomLogo.png",     // 适配其他皮肤的 1x logo 的路径
	'2x' => "$wgResourceBasePath/hiResLogo.png",  // 适配其他皮肤的 2x logo 的路径
];

路径示例

在这个例子中，相对文件路径或 URL 的选择没有特殊含义。
$wgLogos = [
	'1x' => "/lol.png",    // 相对于文档根目录的路径
	'1.5x' => "https://mywiki.org/w/resources/assets/lol.png",  // 指向其他地方的完整 URL
	'2x' => "/lol.png",    // 相对路径始终使用斜杠 / 开头
	//  'svg' => "",       // SVG 键已被弃用
	'icon' => "/lol.png",  // 50×50 SVG 或 100×100 PNG （受限的支持support）
	'wordmark' =>  [
		'src' => "/wordmark_sitename.png",  // 站点名称文本的图像显示（受限的支持）
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "/tagline_subtitle.png",   // 不含站点名称的标语文本的图像显示（受限的支持）
		'width' => 135,
		'height' => 15,
	],
];

添加標誌語言變體

为多种不同的语言变体进行 logo 覆盖替换的功能在 1.36.0 的版本中（Gerrit change 627939, git #8cd2e133）引入。 请参阅T261153。

在定义变体时，可以使用任何语言键，例如可以提供一个英文标志的德语变体。

这个功能在 1.39.0 版本中扩展到适用于所有的 logo 键。 

$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",          // 不含文字标识和标语的 logo
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",  // wordmark 的路径
		'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",	  // tagline 的路径
		'width' => 135,
		'height' => 15,
	],
	'variants' => [
		'variant-code' => [
			'1x' => "path/to/language_variant_1x_version.png",      // 适用于语言变体的 1x logo 路径
			'1.5x' => "path/to/language_variant_1.5x_version.png",  // 适用于语言变体的 1.5x logo 路径
			'2x' => "path/to/language_variant_2x_version.png",      // 适用于语言变体的 2x logo 路径
			'svg' => "path/to/language_variant_svg_version.svg",    // 适用于语言变体的 SVG 路径
			'icon' => "path/to/language_variant_icon.png",          // 适用于语言变体的，不含文字标识和标语的 logo
			'wordmark' => [
				'src' => "path/to/language_variant_wordmark_version.png",  // 适用于语言变体的 wordmark 路径
				'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,
			],
		],
	],
];

参见

Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:$wgLogos/zh&oldid=8113491"