手册:$wgAppleTouchIcon

This page is a translated version of the page Manual:$wgAppleTouchIcon and the translation is 75% complete.
服务器URL及文件路徑: $wgAppleTouchIcon
当 Apple 手持设备将 wiki 收藏到主屏幕时可选的指向一个图标的 URL
引进版本:1.12.0 (r29942)
移除版本:仍在使用
允许的值:(相对路径或绝对路径URL)
默认值:false

详情

当你从 Safari 保存一个书签到主屏幕时,Apple 的 iPhone,iPod Touch 以及 iPad 设备能够显示一个图标。 这类似于 Favicon,但尺寸更大(57x57,72x72 及 114x114 像素,取决于设备)。

Safari网页内容指南建议将名为 "apple-touch-icon.png "的文件放置在网站的文档根目录中;使用 "apple-touch-icon-precomposed.png "可避免iOS为图标创建的圆角和光泽效果。 但是,有时候你可能需要一个自定义图标,那么你可以使用这个格式:

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

这会在 HTML 头输出里添加一个‎<link>标签:

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

因为$wgAppleTouchIcon 默认被设为 false,MediaWiki 不会生成链接,然后浏览器会尝试加载“/apple-touch-icon.png”。 如果这也没有,浏览器会使用页面的缩略图做图标,这样完全不吸引人。

使用覆盖选项,维基可以设置与同一主机上其他页面不同的图标,也可以选择设置自定义 URL。

对于安卓设备,将"apple-touch-icon-precomposed.png"放在根目录下,并将$wgAppleTouchIcon = "$wgScriptPath/apple-touch-icon-precomposed.png";放在LocalSettings.php中。

指引

 
An iPhone home screen including some custom site icons.

图像干净、清晰度和对比度高,背景颜色鲜艳,可以与其他图标很好地搭配。 如果没有可以测试的设备,请参考方便的屏幕截图,如这里的截图。

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. Wikimedia projects currently (May 2021) use 152×152 pixel.

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.


參見