Extension:MobileFrontend/ja

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

要件

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

環境設定
MobileFrontend supports various configuration options that you can define in LocalSettings.php after calling. 単純なサイトでは、ただ動かすために必要なのは  の追加のみかもしれないことに留意してください.

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

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


 * GeoData をインストールする
 * update.php を実行する
 * LocalSettings.php に $wgMFNearby = true; を追加する
 * 1 つ以上のページにデータを追加する  構文の詳細については GeoData の説明書を参照してください.

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

追加の調整
Get the most out of MobileFrontend by adding these other optional dependencies:


 * Extension:Geodata - get Special:Nearby and geotag your articles
 * Extension:PageImages - adds images to search and nearby results
 * Extension:VisualEditor - add Visual editing to your mobile experience.

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:
 * page</tt>: Title of page to process.
 * sections</tt>: Pipe-separated list of section numbers for which to return text or all</tt> for all sections.
 * redirect</tt>: Whether redirects should be followed, yes</tt> (default) or no</tt>. This parameter is intentionally made similar to the one to index.php.
 * prop</tt>: Which information to get:
 * text</tt>: HTML of selected section(s)
 * sections</tt>: Information about all sections on page
 * normalizedtitle</tt>: Normalized page title, will be returned only if it differs from the specified one.
 * sectionprop</tt>: 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.
 * noimages</tt>: Return HTML without images.
 * noheadings</tt>: 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" を使うことができます.

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

関連項目

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