Extension:MobileFrontend/zh

移动前端（MobileFrontend）扩展：


 * 为您的移动端流量创建一个单独的移动网站.
 * 系统管理员可以提供一个不同的皮肤，例如 Skin:MinervaNeue
 * 为使你的内容更友好，提供各种内容转换
 * 容易注意的小节收起和内容重排和删除.
 * 简化移动端页尾并添加一个桌面/移动版网站链接
 * 针对不适合移动端的特殊页面，提供替代的页面： Special:History, Special:Contributions, Special:Watchlist, Special:Preferences, Special:MobileDiff
 * 提供特殊页面 Special:Nearby, Special:MobileOptions (用于移动端皮肤偏好设置), Special:MobileLanguages (用于语言选择).
 * 提供beta模式，其包含一个功能管理系统，用于为匿名用户添加实验性功能

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

先决条件

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

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

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

配置附近
移动前端提供了“Special:附近”页面，这需要一些配置. 为了使其工作，需要一些可选的步骤：


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

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

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

配置设置
参见

额外调整
Get the most out of MobileFrontend by adding these optional compatible extensions:


 * - Get Special:Nearby and geotag your articles.
 * - Adds images to search and nearby results.
 * - Add Visual editing to your mobile experience.

CSS 样式
To apply CSS to your mobile theme, edit MediaWiki:Mobile.css, the counterpart of MediaWiki:Common.css.

MobileFrontend does not load the global MediaWiki:Common.css, neither does it load any of the user stylesheets.

更多信息
If you would like to test the mobile extension on a desktop browser or your device doesn't render the mobile version, you can append the following key-value pair to the URL query string:. For example: https://en.wikipedia.org/wiki/Chuck_Schuldiner?useformat=mobile

If you would like to view the mobile version of a page without enabling the extension across the entire site you can append the string too the url on that page, too.

移动前端的过时功能
MobileFrontend has traditionally been a very large extension. Many features have either surpassed their requirements or will do at some future date. These are listed below.

API
APIs are provided by the MobileFrontend extension, but long term we expect to deprecate them in favour of Mobile Content Service. Use these APIs at your own risk. They may disappear (although we will give you sufficient notice when they do)!

MobileView API
See.

扩充 action=parse
accepts extra parameters:

Apply mobile main page transformations.
 * : Return rendered page HTML in a mobile format . Prior to MediaWiki 1.23, you could specify  to output HTML for modern phones or   to output WML for dumb phones (see mailing list messagefor details).
 * : Disable images in mobile output.

示例：

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来运行预调试挂钩，这取决于您对扩展的配置.

使用外语维基上的文章进行测试（实时数据）
MobileFrontend can now be configured locally to render articles from other MediaWiki instances. This can help you debug problems locally instead of importing articles which may have dependencies on various templates and Wikibase identifiers from production to your local instance. This is not recommended for production usage.

The code below will turn your local MediaWiki mobile site into a Wikivoyage viewer:

This is particularly useful for testing different mobile skins using the wgMFDefaultSkinClass config option.

基金会网站
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.

常见问题
The following questions frequently appear on our talk page. Please check this list before posting about them on the talk page or use the existing talk topic, if available, to receive clarifications.

Q: How do I customise the main menu of the Minerva skin?
A: This is tracked in phabricator but you can see Topic:Tiggc18fvd3stmsf has an interim solution.

Q: How do I add HTML to the Minerva skin, for example to add ads or additional script tags?
A: You can do this by editing the template file for the skin (currently ). See this discussion for details.

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