Manual:$wgLogos
サーバー 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
andheight
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.
すべての値(width
とheight
を除く)は、完全修飾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,
],
],
],
];
サーバーの設定によっては、どの画像を使用するかの情報がサーバーキャッシュ内にキャッシュされることがあります。 また、対応する画像ファイルを変更した場合、画像がウェブ ブラウザー内に長期間キャッシュされ、新しいロゴがすぐに表示されない場合があります。 この場合、キャッシュを空にして、ブラウザーがサーバーから最新バージョンをダウンロードできるようにするため、ウェブ ブラウザーで画像 URL を再読み込みする必要がある場合があります。 |
関連項目
- ロゴを変更するには?
- $wgLogo (MediaWiki < 1.35.0)
- $wgLogoHD (MediaWiki < 1.35.0)
- $wgFavicon
- $wgAppleTouchIcon