Extension:MobileFrontend/ja

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

要件

 * MediaWiki には不要ですが、この拡張機能の動作のため PHP に mbstring サポートが必要です.
 * MobileFrontend の MediaWiki ≤ 1.24 向けリリースには Mantle 拡張機能が必要です.

環境設定
MobileFrontend は様々な設定オプションをサポートしています. それらは LocalSettings.php において  を呼び出した後に定義することができます. 単純なサイトでは、ただ動かすために必要なのは  の追加のみかもしれないことに留意してください.

モバイルブラウザ自動検出の設定
/Configuring browser auto-detection を参照してください.

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 エンドポイントは与えられた場所と関係のあるコンテンツを検索するために使用されます.

追加の調整
以下のオプションの依存機能を追加して 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

Wap 版のモバイル拡張を見たい場合は、代わりに ?useformat=mobile-wap を使用してください.

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

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

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

例:

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

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
'' に移行されました. ''

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

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

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

ウィキメディア財団以外のサイト
非 WMF サイトでは、WMF で行われる動作（プロキシ層でのデバイス検出および固有の 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.

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

関連項目

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