Jump to content

Manual:$wgLogos

From mediawiki.org
This page is a translated version of the page Manual:$wgLogos and the translation is 67% complete.
サーバー URL とファイル パス: $wgLogos
各種ウィキロゴのURLパスです。
導入されたバージョン:1.35.0 (Gerrit change 562588; git #8cd2e133)
除去されたバージョン:使用中
許容される値:(倍率と相対パス又はURLの配列)
既定値:false
(注: この変数の既定値は、他の変数に依存します。例えば、LocalSettings.php の実行後に Setup.php 内で値が設定される変数です)

詳細

警告! 警告: Do not simply overwrite the default logo installed within MediaWiki (/resources/assets/wiki.png); this file will be overwritten when you upgrade the software.
A larger size can be used by modifying the site’s CSS, but MediaWiki will not resize a logo that is too large. Instead, only part of the image (specifically the upper left-hand corner) will be displayed, and if this corner is white, it may seem like the image is not displaying.
The recommended size for a square logo is 135 × 135px, though the logo doesn’t have to be square, especially if it includes text below an image. The maximum logo size in the Vector skin is ~160 × 160px, while in MonoBook it’s ~155 × 155px.

ウィキロゴの異なるバージョンへの因子とそれらに関連する相対パスまたはURLパスがある配列。 (即ち、殆どのMediaWikiのインストールでページの左上隅に表示される画像)

対応キー

アイコンバージョン
正方形で、HiDPIに対応するためにSVGの場合は公称50×50ピクセル、ラスターの場合は100×100ピクセルである必要があります。 ただし、SVGを推奨します。 現在、このキーのサポートは Skin:ベクター , Skin:Timeless , Skin:Refreshed , Skin:Citizen に限定されていますが、すべての新しい外装でこれを推奨します。 他の外装がこれに対応している場合、通常より大きなアイコンを必要とするため、代わりに SVG を使用することをお勧めします。
* 等倍版
it should be 135px wide by up to ~155px tall. これは、1.5 倍版と 2 倍版は公称幅 135px を想定しており、高さ 155px までなら標準的な外装で問題なく収まるからです。 これは古い外装をサポートしており、長期的な将来には廃止予定となる予定です。 お好みの「アイコン」をサポートする外装をお勧めします。
* 1.5倍版
it should 202px wide, matching the aspect ratio of the 1×. (つまり、公称高さ155pxに対して、最大232pxの高さまで) このキーは将来的に非推奨となり、その使用は推奨されない。
* 2倍版
it should be 270px wide, matching the aspect ratio of the 1×. (つまり、公称高さ155pxに対して、最大310pxの高さまで) このキーは将来的に非推奨となり、その使用は推奨されない。
* svg版
it 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. このキーは将来的に非推奨となり、その使用は推奨されない。

また、ロゴの横に表示する追加アセット用のオプションフィールドが2つあります。

wordmark
it should be a landscape logo, with maximum set width or height, as these are specified under the width and height keys. The width shouldn't exceed 124 and the height shouldn't exceed 32px. これは通常、$wgSitenameのグラフィック版である。 これは、Skin:ベクター (1.36)、Skin:Timeless Skin:Minerva Skin:Citizen で使用されています。
tagline
タグラインも同様で、通常はMediaWiki:Taglineのサイト名でない部分に相当します。 The combined height of the tagline and wordmark should not exceed 50px.

すべての値(widthheightを除く)は、完全修飾URLかDOCUMENT_ROOTからの相対パスのどちらかになります。 相対パスの場合は、スラッシュで始まる必要があります(DOCUMENT_ROOTのファイルは/file.pngであり、file.pngではない)。 その代わり、画像の一部(正確には左上隅)だけが見えるように切り取られます。 このコーナーが真っ白だと、画像が表示されないように見えるかもしれませんが、実際には表示されています。

Example images

$wgLogos = [
	'1x' => "path/to/1x_version.png",		// 1倍版へのパス
	'1.5x' => "path/to/1.5x_version.png",	// 1.5倍版へのパス
	'2x' => "path/to/2x_version.png",		// 2倍版へのパス
	'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,
	],
];


簡易版の例

$wgLogos = [
	'icon' => "$wgScriptPath/lol.png",			// path to icon, the primary logo for Vector
	'1x' => "$wgScriptPath/myCustomLogo.png",			// path to 1x version
	'2x' => "$wgResourceBasePath/hiResLogo.png",		// path to 2x version
];

パスの例

$wgLogos = [
	'1x' => "/lol.png",												// relative path to file in logo folder, 1x version
	'1.5x' => "https://mywiki.org/w/resources/assets/lol.png",	// fully qualified URL path to 1.5x version
	'2x' => "/lol.png",												// relative path to 2x version, which always starts with a slash
	//  'svg' => "",													// no svg (deprecated by MW)
	'icon' => "lol.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,
	],
];

言語変種にロゴを追加

The functionality to override logos for different language variants was introduced in version 1.36.0 (Gerrit change 627939, git #8cd2e133). 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",		// 1倍版へのパス
	'1.5x' => "path/to/1.5x_version.png",	// 1.5倍版へのパス
	'2x' => "path/to/2x_version.png",		// 2倍版へのパス
	'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",		// 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",	// 言語変種からwordmark版へのパス
				'1x' => "path/to/language_variant_wordmark_version.svg",	// SVG 対応のブラウザで言語変種に対して SVG ロゴを加えるオプション。
				'width' => 135,
				'height' => 20,
			],
		],
	],
];

関連項目