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（实验性皮肤）

配置设置
参见

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


 * - 获得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
接受额外参数：


 * Return rendered page HTML in a mobile format.
 * Return rendered page HTML in a mobile format.


 * Disable images in mobile output.
 * Disable images in mobile output.


 * Apply mobile main page transformations.
 * Apply mobile main page transformations.

示例：

meta=siteinfo
The domain of the mobile version of the site (which might or might not be the same as the normal domain) is available under the  key of the general siteinfo information.

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

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

基金会网站
On Wikimedia Foundation-run sites, we use Varnish caching servers to check the user agent of your device.

非基金会网站
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: The extension I am using doesn't seem to work on MobileFrontend. Why?
A: It's likely the extension is old and needs to add compatibility to MobileFrontend. 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: I upgraded MobileFrontend and now I'm getting a fatal exception!
A: You are probably using incompatible versions of MobileFrontend and MediaWiki. In most cases, we can't help you here. Try upgrading MobileFrontend or MediaWiki to resolve your issue.

Q: After upgrading MediaWiki I'm getting an exception wgMFDefaultSkinClass is not setup correctly.
A: MobileFrontend currently assumes you have the skin installed. If you don't you'll need to install this or configure your mobile skin per instructions above.

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

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

参见

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