Extension:MobileFrontend/ja

「MobileFrontend」拡張機能はモバイルフレンドリーな表示を提供します. このページは開発インスタンスにインストールしたいエンドユーザー向けに作られています. 開発および改良の支援を望まれる場合は、ぜひご参加ください.


 * allows sysadmins to provide a different skin e.g. Skin:MinervaNeue and separate mobile site for their mobile traffic.
 * provides various content transformations to make your content more friendly - notably section collapsing and content re-arrangement and removal.
 * provides replacement special pages for MediaWiki pages that are not mobile friendly - Special:History, Special:Contributions, Special:Watchlist, Special:Preferences, Special:MobileDiff.
 * It provides the special pages Special:Nearby, Special:MobileLanguages, Special:MobileMenu and Special:Uploads

This page is designed for end users who want to install it on their development instance. If you are keen to help us build it and improve it we encourage you to get involved.

要件
Before installing MobileFrontend, if you make heavy use of templates and/or inline styles (the style attribute) you should review your content to see whether it is mobile friendly. The TemplateStyles extension can be used to style content so that it renders nicely on mobile and desktop. MobileFrontend will not magically fix this for you!
 * MediaWiki には不要ですが、この拡張機能の動作のため PHP に mbstring サポートが必要です.
 * MobileFrontend の MediaWiki ≤ 1.24 向けリリースには Mantle 拡張機能が必要です.

In particular, you may want to review your landing page (main page). See Mobile homepage formatting.

Nearby のインストール
MobileFrontend はわずかな設定で特別:付近ページを提供します. これを得るためには数段階のオプションステップを行うことが必要です：


 * Due to browser security you will need to be running a secure site over SSL - it is not possible to request a users location over http
 * GeoData をインストールする
 * update.php を実行する
 * LocalSettings.php に $wgMFNearby = true; を追加する
 * 1 つ以上のページにデータを追加する  構文の詳細については GeoData の説明書を参照してください.

あるいは、LocalSettings に以下の 2 行を追加して Nearby 用の異なる MediaWiki インスタンスを使用することが可能です. Nearby エンドポイントは与えられた場所と関係のあるコンテンツを検索するために使用されます.

Setup a skin
MobileFrontend provides you with a mobile formatted website to go alongside your existing desktop website. You can skin it however you want. The following skins are compatible with MobileFrontend:
 * Skin:Minerva (stable, default on WMF wikis)
 * Skin:Vector (default desktop skin, uses an experimental responsive mode for mobile)
 * Skin:Timeless (experimental skin)

追加の調整
以下のオプションの依存機能を追加して MobileFrontend を最大限に活用しましょう.


 * Extension:Geodata - 特別:付近を追加し、記事にジオタグを付けます
 * Extension:PageImages - 検索と付近の結果に画像を追加します
 * Extension:VisualEditor - モバイルエクスペリエンスにビジュアル編集を追加します

CSSスタイル
モバイルテーマに CSS を適用するには、MediaWiki:Mobile.css を編集してください. これは MediaWiki:Common.css に対応するものです.

詳細情報
デスクトップブラウザでモバイル拡張機能をテストしたい場合やデバイスがモバイル版を表示しない場合には、以下のキー・値ペアをクエリ文字列に追加することができます：?useformat=mobile 例：https://en.wikipedia.org/wiki/Chuck_Schuldiner?useformat=mobile

サイト全体に渡ってベータ機能を有効にすることなくページをベータ版で表示したい場合は、任意のページのクエリ文字列に以下を追加することができます：

Wiki に常にモバイルビューで表示させるためには、LocalSettings.php に以下を追加してください：

Legacy features of MobileFrontend
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)!

拡張された action=parse
action=parse は追加のパラメータを受け付けます：
 * mobileformat=:モバイル形式のレンダーされたページ HTML を返します.  MediaWiki 1.23 より前では、mobileformat=html を指定してモダンな携帯電話向けの HTML を出力するか、mobileformat=wml を指定して低機能携帯電話向けの WML を出力することができました（詳細はメーリングリストのメッセージを参照してください）.
 * noimages:モバイル出力で画像を無効にします.
 * mainpage:モバイルにメインページ変換を適用します.

例:

action=mobileview
モバイルアプリや動的セクションビューを使用するモバイルデバイスに最適化されたコンテンツを配信します. 制限された action=parse 機能とほぼ同等ですが、より柔軟で、また常にページ全体の構文解析から得られる分割された節を返します.

Parameters:
 * : Title of page to process.
 * : Pipe-separated list of section numbers for which to return text or  for all sections.
 * : Whether redirects should be followed,  (default) or  . This parameter is intentionally made similar to the one to index.php.
 * : Which information to get:
 * : HTML of selected section(s)
 * : Information about all sections on page
 * : Normalized page title, will be returned only if it differs from the specified one.
 * : What information about sections to get: pipe-separated list of value types defined by parser. It's the same as in action=parse: toclevel, level, line, number, index, fromtitle, anchor. "byteoffset" has been excluded as it makes no sense for this action.
 * : Return HTML without images.
 * : Return HTML without headings.

返された節の情報はすべての節の id</tt> も含みます. これは 0 から始まる番号です. また、Cite によって追加された脚注を含む節については、references</tt> データメンバも存在します.

例:

XML での同じリクエスト：

[//www.mediawiki.org/w/api.php?action=mobileview&page=Extension:MobileFrontend/Example&sections=0&prop=text|sections&format=xmlfm api.php?action=mobileview&page=Extension:MobileFrontend/Example&sections=0&prop=text|sections&format=xml]

prop=extracts
'' に移行されました. ''

Testing with articles on a foreign wiki (live data)
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.

ウィキメディア財団のサイト群
Wikimedia 財団の運営するサイトでは、デバイスのユーザーエージェントを調べるために Varnish キャッシュサーバーを利用しています. 閲覧者のユーザーエージェントがモバイルデバイス由来であるように見える場合、Varnish サーバーはリクエストに対して適切な 'X-Device' ヘッダを設定し、閲覧者は記事の MobileFrontend 版へリダイレクトされます. また、フッタの「モバイルビュー」をクリックしたり、クエリ文字列に "useformat=mobile" を追加したりすることで、記事をモバイルビューで見ることができます. 例：

X-Device を設定する Varnish サーバーの vcl 設定 記事のモバイル版を見ているがデスクトップ版を見たい場合には、「この記事を通常の＜サイト名＞で閲覧する」をクリックして戻すことができます.

Web ブラウザで恒久的にモバイルビューを無効化したい場合は、「恒久的にモバイルサイトを無効化する」をクリックすることができます. これは WMF のサーバーに常にサイトのデスクトップ版を表示するよう指示する cookie を設定します.

ウィキメディア財団以外のサイト
ウィキメディア財団以外のサイトでは、ウィキメディア財団で行われる動作（プロキシ層でのデバイス検出および固有の X-Device ヘッダ設定）を模倣するように設定するか、記事がモバイルビューを使うように切り替えるため単に "?useformat=mobile" を使うことができます.

FAQ
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 include/skins/minerva.mustache). 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.org (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.

A2: A skin was split off by the developers. Quickly put a skin back on.

拡張機能の開発者向け
既定では、拡張機能内のリソースモジュールはモバイルビューでは読み込まれません. モバイルビューでもモジュールが読み込まれる必要がある場合には、この MobileFrontend フレンドリーなモジュールを書くためのガイドが役立つでしょう.

関連項目

 * Wikimedia の MobileFrontend 設定ファイル
 * Wikimedia の MobileFrontend 設定ファイル
 * Wikimedia の MobileFrontend 設定ファイル