配置附近(Nearby)功能

移动前端提供了Special:Nearby页面，它帶有一点点配置。你需要做一些事情以使其生效：

1. 由于浏览器的安全考慮，您需要在使用SSL的安全站点上运行--絕對无法通过HTTP请求用户的位置。
2. 安装GeoData扩展
3. 运行update.php
4. 在LocalSettings.php中加入$wgMFNearby = true;
5. 确定條目的坐标点：
   1. 使用coordinates解析器函数来向您的條目中加入位置数据，例如{{#coordinates:37.786971|-122.399677|primary}}。 关于语法细节，参见GeoData 文档。
   2. 作为替代，您也可以为Nearby使用一个独立的MediaWiki安装，这需要在您的LocalSettings.php文件中设置$wgMFNearbyEndpoint。 例如，$wgMFNearbyEndpoint = 'https://en.m.wikipedia.org/w/api.php';会使用英文维基百科上條目的坐标。 附近的端点将用于查找与给定位置相关的内容。

设置皮肤

移动前端提供给您适合移动版格式的网站，这与已存在的桌面版网站可以共存。您可以任意设置其皮肤。

// 选择其中一个并在LocalSettings.php文件底部加入你选的代码：
wfLoadSkin( 'MinervaNeue' );
$wgDefaultMobileSkin = 'minerva'; // 使用Minerva皮肤 （对于1.37或更旧的版本，你需要单独下载并安装，否则你会得到异常）
wfLoadSkin( 'Vector' );
$wgDefaultMobileSkin = 'vector'; // 使用Vector皮肤
wfLoadSkin( 'Timeless' );
$wgDefaultMobileSkin = 'timeless'; // 使用Timeless皮肤

以下皮肤兼容於移动前端：

• Skin:Minerva Neue（稳定，在维基媒体基金会的各個wiki中是默认值）
• Skin:Vector（默认的桌面版皮肤，对于移动版則是使用了实验性的响应模式）
• Skin:Timeless（实验性的皮肤）
• :MonoBook
• :公民 (responsive skin)

额外调整

通过添加这些兼容的扩展的選項，最大限度地发挥移动前端的作用：

• : - 获得Special:Nearby并地理位置標記你的條目。
• : - 添加图像到搜索和nearby的结果。
• Extension:VisualEditor - 添加可视化编辑到你的移动版体验。

CSS 样式

要为移动主题应用CSS，请编辑MediaWiki:Mobile.css，与MediaWiki:Common.css相对。 要让样式表生效，你需要将mw.loader.using('mobile.site.styles')添加到你的MediaWiki:Mobile.js。

移动前端不会加载全局MediaWiki:Common.css，也不会加载任何用户样式表。

更多

如果您想在桌面浏览器上测试移动扩展，或者想让您的设备不呈现移动版本，您可以将以下键值对附加到URL查询字符串：?useformat=mobile。例如：https://en.wikipedia.org/wiki/MediaWiki?useformat=mobile

如果您想查看页面的移动版本而不在整个站点上启用扩展，您也可以将字符串附加到该页面上的URL。

API

移动前端扩展提供了API，但长期来看我们会弃用，以支持页面内容服务。 使用这些API需要承担风险。 这些API可能会消失（尽管那时我们会充分通知您）！

{
    "parse": {
        "title": "Therion (band)",
	    "text": {
            "*": "<div><table class=\"infobox vcard plainlist\" style=\"width:22em\"><tr><th colspan=\"2\" style=\"text-align:center;font-size:125%;font-weight:bold;background-color: #b0c4de\"><span class=\"fn org\">Therion</span></th>\n</tr><tr><td colspan=\"2\" style=\"text-align:center\"><a href=\"/wiki/File:2130860153_281d30b3bf_b.jpg\" class=\"image\">
            ...

你可能需要运行npm install并安装php composer以使得预提交的钩子得以运行，这取决于你对扩展的操作。

使用外语wiki上的條目进行测试（实时数据）

参见Extension:MobileFrontendContentProvider 。

基金会网站

在维基媒体基金会运营的网站，我们使用Varnish缓存服务器来检查您设备的用户代理。

非基金会网站

对于非维基媒体基金会的网站，你可以设置你的配置来模仿维基媒体基金会的工作方式（在代理层进行设备检测并设置特定的X-设备的標头信息），或者你可以简单地使用「?useformat=mobile」来切换條目以使用移动视图。 See 扩展:移动前端/配置浏览器自动检测 .

<IfModule mod_headers.c>
<If "req('Host') =~ /^mobile./i">
RequestHeader set X-Subdomain "mobile"
</If>
</IfModule>

127.0.0.1  mobile.localhost

wfLoadExtension('MobileFrontend');

$wgMFAutodetectMobileView = true;
$wgMobileUrlCallback = fn( $domain ) => "mobile.$domain";

Q: How do I detect the mobile site in frontend code?

Ideally you shouldn't need to do this. It is preferable to use mw.config.get('skin') or window.matchMedia('(max-width: 1119px)').matches to detect a mobile user. You can also make use of the stable mw-mf class which is present on the BODY element if the mobile site is active.

If your code makes modifications to content, you may need to update your code to consider MobileFrontend markup by inspecting the DOM for presence of certain elements.

Please note while mw.config.get( 'wgMFMode' ) exists and can be used by extensions as a last resort (for now) it should not be considered stable for use by gadgets.

Q：我应该如何自定义Minerva皮肤的主菜单？

A：这在phabricator上有追蹤，但您可以在Extension talk:MobileFrontend/2017#h-MODIFY THE MAIN MENU-2017-01-04T02:24:00.000Z找到過渡期間的解决方案。

Q：我应该如何在Minerva皮肤中加入HTML，例如添加广告或额外的script标签？

A：您可以通过编辑皮肤的模板文件来达到此目的（目前位于include/skins/minerva.mustache）。参见此讨论以获取更多细节。

Q：我是用的扩展似乎不对移动前端生效，为什么？

A：有可能扩展太旧了，需要加入对移动前端的兼容。 请联系该扩展的开发者，并将他们指向ResourceLoader/编写一个移动前端友好的ResourceLoader模块。 请不要在讨论页上发帖，因为在这种情况下，最好在Phabricator上提交一个错误（你可以用你在MediaWiki.org的用户名登录），以获得更快的回应。

Q：我升级了移动前端的扩展，然后遇上致命的异常！

A：可能你用的是不兼容的移动扩展和MediaWiki版本。 一般在这种情况，我们爱莫能助。 尝试升级移动前端或者MediaWiki来解决问题。

Q：升级MediaWiki后，遇上异常：wgMFDefaultSkinClass设置不正确。

A：当下移动前端假定你有安装了Minerva Neue 皮肤。 如果没有，你就需要安装這個，或者按照上面的指引来配置你的移动版皮肤。