Extension:MobileFrontend/ja

「MobileFrontend」拡張機能は：


 * モバイルトラフィック向けの独立したモバイルサイトを作成します.
 * システム管理者は Skin:MinervaNeue のような異なる外装を提供できます.
 * コンテンツをより扱いやすくするため、様々なコンテンツ整形機能を提供します.
 * 特に節の折り畳みならびにコンテンツの再配列および除去.
 * モバイル用のフッターをシンプルにし、デスクトップ用/モバイル用を切り替えるリンクを追加します.
 * モバイル フレンドリーではない特別ページの代替を提供します: Special:History, Special:Contributions, Special:Watchlist, Special:Preferences, Special:MobileDiff
 * 特別ページ Special:Nearby、Special:MobileOptions （モバイル用外装設定）、Special:MobileLanguages（言語の選択用）を提供します
 * ベータモードを提供し、機能管理システムによって匿名利用者を対象とした試験的機能を追加します.

このページは、開発インスタンスにインストールしようとする利用者向けです. また開発したり、改良を手伝ってくださる方の参加もお待ちしています.

要件

 * この拡張機能の動作には MediaWiki には必要条件はありませんが、 PHP の mbstring のサポートが必要です.

MobileFrontend をインストールする前に、テンプレートやインラインのCSSスタイル（ 属性）を多用している場合には、モバイルに適しているかコンテンツを見直してください. 拡張機能はモバイルやデスクトップにて、コンテンツがうまく描画されるようデザインするのに使えます. MobileFrontend には、魔法のような修正をかける機能はありません！

特に、ランディングページ（ホームページ）を見直してください. モバイル・ゲートウェイ/モバイル用ホームページ整形を参照してください.

Nearby のセットアップ
MobileFrontend は、わずかな設定で Special:Nearby （特別:付近）ページを提供します. このためには少しオプションの設定が必要です.


 * 1) ブラウザのセキュリティを確保するため、SSL経由の安全なサイトで実行する必要があります. HTTP経由で利用者の位置情報を要求することはできません.
 * 1) GeoData 拡張機能 をインストールする.
 * 2)  を実行する.
 * 3) LocalSettings.php に   を追加する
 * 4) 記事の座標を決定する:
 * 5) 1 つ以上のページにデータを追加する   構文の詳細については GeoData の説明書を参照してください.
 * 6) LocalSettings.phpファイルに を設定することで、Nearby に別のMediaWiki インスタンスを使用することもできます.  たとえば、 は英語版ウィキペディアの記事の座標を使用します. この NearbyEndpoint は、その位置情報に関連するコンテンツを見つけるために使用されます.
 * 1)  を実行する.
 * 2) LocalSettings.php に  を追加する
 * 3) Determine article coordinates:
 * 4) Add location data to your articles by using the   parser function, for example  . For syntax details, see the documentation for.
 * 5) Alternatively you can use a separate MediaWiki installation for Nearby by setting   in your LocalSettings.php file. For example,   will use coordinates of English Wikipedia articles. The nearby endpoint will be used to find content related to a given location.

外装のセットアップ
既存のデスクトップ版サイトと並行して、MobileFrontend はモバイル用に成形されたウェブサイトを提供します. 必要なら外装を使用できます.

以下の外装は MobileFrontend と互換性があります:
 * Special:MyLanguage/Skin:Minerva Neue (安定版、WMF のウィキ群の既定の外装)
 * Special:MyLanguage/Skin:Vector (デスクトップ用の既定の外装、モバイルでは実験的なレスポンシブ・モード)
 * Special:MyLanguage/Skin:Timeless (実験的な外装)

環境設定
を参照

追加の調整
以下のオプションの関連機能を追加することで MobileFrontend を最大限に活用できます.


 * - 特別:付近 (Special:Nearby) を追加し、記事にジオタグが指摘できます.
 * - 検索と「付近」の結果に画像を追加します.
 * - モバイル用のビジュアル編集機能を追加します.

部分的なカスタマイズ
=== CSSスタイル

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

MobileFrontend は、広範に適応されている MediaWiki:Common.css を読み込まず、利用者のスタイルシートをどれも読み込みません.

詳細情報
デスクトップのブラウザやモバイル版を表示しない端末から、モバイル拡張機能をテストしたい場合、以下のキーと値の組み合わせをクエリの文字列に追加します： 例：https://en.wikipedia.org/wiki/Chuck_Schuldiner?useformat=mobile

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

MobileFrontend の歴史の長い機能
MobileFrontend は、長く使われ巨大な拡張機能になっています. 多くの機能は、必要以上になっている、あるいはいずれそうなるでしょう. そうした機能を挙げていきます.

API
API は MobileFrontend 拡張機能によって提供されていますが、私たちは、長期的には モバイルコンテンツサービス を優遇していき、API を廃止する予定です. これらのAPIは自己責任で使用してください. 消去される可能性あります（とはいえ十分にお知らせしてからです）.

モバイルビュー API
を参照.

拡張された action=parse
accepts extra parameters:
 * : 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.
 * : Apply mobile main page transformations.

例:

meta=siteinfo
一般的な siteinfo 情報の  キーから、サイトのモバイル版のドメイン（通常のドメインと同じでない場合、同じ場合があります）を取得することができます.

セットアップ
You may need to run  and install php composer to get the precommit hook to run, depending on what you're doing with the extension.

外部ウィキ上の記事を使ったテスト（ライブデータ）
MobileFrontend は、他の MediaWiki インスタンス由来の記事をローカルに表示するよう設定することができるようになりました. これは、様々なテンプレートや Wikibase 識別子に依存している可能性がある記事をプロダクションからローカルインスタンスに取り込むことなく、ローカルに問題をデバッグすることに役立ちます. プロダクション使用では推奨されません.

以下のコードは、あなたのローカル MediaWiki モバイルサイトを Wikivoyage ビューアに変えます.

これは特に、wgMFDefaultSkinClass 構成設定を使用する異なるモバイル外装をテストするときに役立ちます.

ウィキメディア財団のサイト群
Wikimedia 財団の運営するサイトでは、デバイスのユーザーエージェントを調べるために Varnish キャッシュサーバーを利用しています.

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

よくある質問
議論ページで、以下の質問が頻繁にあります. 議論ページでそれらについて投稿する前にこの一覧を確認するか、もし可能ならば、既存の議論トピックを使用して説明を受けてください.

Q：Minerva 外装のメインメニューをカスタマイズするにはどうしますか？
A：この件について phabricator で議論されていますが、Topic:Tiggc18fvd3stmsf に暫定的な解決策が掲載されています.

Q：Minerva 外装に広告や追加の script タグのような HTML を追加するにはどうしますか？
A：スキンのテンプレートファイル（現在は include/skins/minerva.mustache）を編集することによって可能です. 詳細については、この議論を参照してください.

Q：使用している拡張機能が MobileFrontend では動作しないようです. なぜでしょうか？
A：おそらく、拡張機能が古く、MobileFrontend との互換性を追加する必要があります. 拡張機能の開発者に連絡し、ResourceLoader/Writing a MobileFrontend friendly ResourceLoader module を参照するようお伝えください. 迅速に対応してもらうには、議論ページに投稿するのではなく、この場合は Phabricator（あなたの MediaWiki.org 利用者名を使用してログインできます）でバグを報告するのがよいでしょう.

Q：MobileFrontend を更新すると、致命的な例外が発生してしまいました！
A：おそらく互換性のないバージョンの MobileFrontend と MediaWiki を使用しています. 多くの場合、ここではお力になれません. 問題を解決するには、MobileFrontend または MediaWiki を更新してみてください.

Q：MediaWiki の更新後、wgMFDefaultSkinClass is not setup correctly という例外が発生します.
A：現在、MobileFrontend は 外装がインストールされていることを前提とします. インストールしていない場合は、上記の説明に従い、この外装をインストールしてモバイル外装として設定する必要があります.

拡張機能の開発者向け
既定では、拡張機能内のリソースモジュールはモバイルビューでは読み込まれません.

モバイルビューでもモジュールが読み込まれる必要がある場合には、この MobileFrontend フレンドリーなモジュールを書くためのガイドが役立つでしょう.

関連項目

 * Wikimedia の MobileFrontend 設定ファイル
 * Commons:Category:MediaWiki extension MobileFrontend
 * Wikimedia の MobileFrontend 設定ファイル
 * Commons:Category:MediaWiki extension MobileFrontend