Jump to content

Manual:$wgAppleTouchIcon

From mediawiki.org
This page is a translated version of the page Manual:$wgAppleTouchIcon and the translation is 33% complete.
サーバー URL とファイル パス: $wgAppleTouchIcon
Apple のハンドヘルド デバイスのホーム画面にブックマークする際に使用するアイコンを指す省略可能な URL
導入されたバージョン:1.12.0 (r29942)
除去されたバージョン:使用中
許容される値:(相対パスまたは絶対 URL)
既定値:false

詳細

Apple's iPhone, iPod Touch and iPad devices have the ability to display an icon when you save a bookmark onto the home screen from Safari. This is somewhat similar to a favicon, but with larger sizes (57x57, 72x72, 114x114 and 144x144 pixels, depending on the device).

Safari Web Content Guide recommends to place a file named "apple-touch-icon.png" in your web site's document root directory; use "apple-touch-icon-precomposed.png" to avoid the iOS-created rounded corners and glossy shine effect for your icon. However, if for some reason you want to use a custom-set icon, you can use the following format:

$wgAppleTouchIcon = "/wiki/icons/apple-touch-icon.png";

This produces a ‎<link> tag in HTML header output:

<link rel="apple-touch-icon" href="/wiki/icons/apple-touch-icon.png" />

As $wgAppleTouchIcon is set to false by default, MediaWiki will not generate the link, and the browser will attempt to load "/apple-touch-icon.png". If this doesn't exist either, a thumbnail of the page is used which is not very attractive.

Using the override option, wikis may set a different icon from other pages on the same host, or may simply choose to set a custom URL.

For Android devices place "apple-touch-icon-precomposed.png" in your root directory, and include $wgAppleTouchIcon = "$wgScriptPath/apple-touch-icon-precomposed.png"; in LocalSettings.php.

ガイドライン

An iPhone home screen including some custom site icons.

Clean images with good sharpness and contrast and a bright colored background will fit in reasonably well with other icons. If you don't have one to test with, refer to handy screen shots such as the one here.

Apple documentation recommends a 114×114 pixel PNG image; however, 118×120 seems to be the mark for retina displays. A smaller image is scaled up slightly, becoming a bit blurry. ウィキメディアのプロジェクト群では現在 (2021年5月)、152×152 ピクセルを採用。

Rounded corners and a "glossy" texture are added by the iPhone UI, so use a flat, square background in your source image:

元の画像: As rendered:

Transparent backgrounds are rendered as solid black.


関連項目