Extension:MobileFrontend/zh

移动前端（MobileFrontend）扩展：


 * 为您的移动端流量创建一个单独的移动网站.
 * 系统管理员可以提供一个不同的皮肤，例如
 * 为使你的内容更友好，提供各种内容转换
 * 值得注意，部分折叠和内容重新排列和删除，包括将引言段落置于引导照片或信息框上方，即使引导段落在页面源代码中位于它们下方.
 * 简化移动端页尾并添加一个桌面/移动版网站链接.
 * 针对对移动端不友好的特殊页面，提供替代的页面： Special:History, Special:Contributions, Special:Watchlist, Special:Preferences, Special:MobileDiff
 * 提供特殊页面 Special:Nearby、Special:MobileOptions（用于移动端皮肤偏好设置）、Special:MobileLanguages（用于语言选择）.
 * 提供beta模式，其包含一个功能管理系统，用于为匿名用户添加实验性功能

本页是为了想要在开发端安装此扩展的用户撰写的. 如果你乐于帮助我们改进，我们欢迎您参与改进.

先决条件

 * 虽然MediaWiki不需要，但PHP必须有mbstring支持以使此扩展工作（）.

在安装移动前端之前，如果您大量使用了模板和/或行内样式（style属性），您需要检查您的内容是否对移动版友好. 扩展可以用于给内容排版，以便让内容在移动版和桌面版都有较好的渲染效果. 移动前端并不会自动为您修复这些内容！

尤其请注意，您可能需要检查您的主页. 請參閱移動首頁格式.

配置附近
移动前端提供了“Special:Nearby”页面，这需要一点配置. 你需要做一些事情以使其生效：


 * 1) 由于浏览器的安全配置，您需要在使用SSL的安全站点上运行：无法通过HTTP请求用户位置.
 * 2) 安装GeoData扩展
 * 运行
 * 1) 在LocalSettings.php中加入
 * 2) 确定文章的坐标点：
 * 3) 使用 解析器函数来向您的文章中加入位置数据，例如 .  关于语法细节，参见文档.
 * 4) 作为替代，您也可以为Nearby使用一个独立的MediaWiki安装，这需要在您的LocalSettings.php中设置.  例如，会使用英文维基百科文章的坐标.  附近的端点将用于查找与给定位置相关的内容.

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

以下皮肤兼容移动前端：


 * Skin:Minerva Neue（稳定，对于维基媒体基金会的wiki是默认值）
 * Skin:Vector（默认的桌面版皮肤，对于移动版提供了实验性的响应模式）
 * Skin:Timeless（实验性皮肤）

配置设置
参见

All configuration options are detailed in the README.md file.

额外调整
添加这些可选的兼容扩展，充分利用移动前端扩展：


 * - 获得Special:Nearby并未文字标记地点.
 * - 给搜索和附近结果添加图像.
 * - 为移动版体验添加可视化编辑.

CSS 样式
要为移动主题应用CSS，请编辑MediaWiki:Mobile.css，与MediaWiki:Common.css相对. 要让样式表生效，你需要将 添加到你的MediaWiki:Mobile.js.

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

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

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

移动前端的过时功能
传统上，移动前端是个非常大的扩展. 许多功能要么超过其要求，要么在未来某个日期实现. 下面列出了这些.

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

MobileView API
参见.

扩充 action=parse
接受额外参数：


 * 以移动格式返回渲染的页面HTML.
 * 以移动格式返回渲染的页面HTML.


 * 在移动输出禁用图像.
 * 在移动输出禁用图像.


 * 应用移动主页转换.
 * 应用移动主页转换.

示例：

meta=siteinfo
网站移动版的域（可能与普通域相同也可能不同）可在一般sinteinfo信息的 键中获得.

设置
您可能需要运行 并安装composer来运行预调试挂钩，这取决于您对扩展的配置.

使用外语维基上的文章进行测试（实时数据）
参见.

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

非基金会网站
For non-WMF sites, you can either set up your configuration to mimic how things are done at the WMF (doing device detection at the proxy layer and setting specific X-Device headers), or you can simply use "?useformat=mobile" to switch an article to use the mobile view.

常见问题
以下问题经常出现在讨论页. 在您提出新话题前，请检查以下列表或检查已有的话题（如果存在的话），以答疑解惑.

Q：我应该如何自定义Minerva皮肤的主菜单？
A：这在phabricator上有记载，您可以在Topic:Tiggc18fvd3stmsf找到临时的解决方案.

Q：我应该如何在Minerva皮肤中加入HTML，例如添加广告或额外的script标签？
A：您可以通过编辑皮肤的模板文件来达到此目的（目前位于 ）. 参见此讨论以获取更多细节.

Q：我是用的扩展似乎不对移动前端生效，为什么？
A：有可能扩展太旧了，需要加入对移动前端的兼容. Please contact the developer of the extension and point them to ResourceLoader/Writing a MobileFrontend friendly ResourceLoader module. Please do not post to the talk page, as in this case it would be better to file a bug on Phabricator (you can login using your MediaWiki.org username) for a quicker response.

Q：我升级了移动前端扩展，然后遇上致命异常！
A：可能你用的是不兼容的移动扩展和MediaWiki. 这种情况我们一般爱莫能助. 尝试升级移动前端或者MediaWiki来解决问题.

Q：升级MediaWiki后，遇上异常：wgMFDefaultSkinClass设置不正确.
A：MobileFrontend当前假定你安装了皮肤. 如果没有，你需要安装，或者按照上面的指引来配置你的移动版皮肤.

对于扩展开发者
默认情况下，扩展中的资源模块将不会在移动视图中加载.

如果一个模块需要在移动版页面中载入，这份关于撰写对移动前端友好的模块的指南很有帮助.

参见

 * 维基媒体移动前端配置文件
 * Commons:Category:MediaWiki extension MobileFrontend
 * 维基媒体移动前端配置文件
 * Commons:Category:MediaWiki extension MobileFrontend