手册:$wgAppleTouchIcon
| 服务器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中。
指引
图像干净、清晰度和对比度高，背景颜色鲜艳，可以与其他图标很好地搭配。 如果没有可以测试的设备，请参考方便的屏幕截图，如这里的截图。
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.