Extension:MobileFrontend/ja

MobileFrontend 拡張機能は、MediaWiki インスタンスのモバイル表示を改善するのに役立ちます.

以下の機能を含みます:


 * モバイルトラフィック向けの独立したモバイルサイトを作成します.
 * システム管理者は のような異なる外装を提供できます.
 * コンテンツをより扱いやすくするため、様々なコンテンツ整形機能を提供します.
 * 特に、セクションの折りたたみ、コンテンツの再配置や削除（ページのソースコードでリード段落がそれらの下にある場合でも、リード写真や情報ボックスの上に置くなど）.
 * モバイル用のフッターをシンプルにし、デスクトップ用/モバイル用を切り替えるリンクを追加します.
 * モバイル フレンドリーではない特別ページの代替を提供します: Special:History, Special:Watchlist, Special:MobileDiff
 * ベータモードを提供し、機能管理システムによって匿名利用者を対象とした試験的機能を追加します.

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

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

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

インストール


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


 * 1) ブラウザのセキュリティを確保するため、SSL経由の安全なサイトで実行する必要があります. HTTP経由で利用者の位置情報を要求することはできません.
 * 2) GeoData 拡張機能 をインストールする.
 * 3)  を実行する.
 * 4) LocalSettings.php に を追加する
 * 5) 記事の位置情報を確認する：
 * 6) 記事に位置情報を追加するには、たとえば など パーサ機能を使用します.  構文の詳細は、の解説文書をご参照ください.
 * 7) 代替策として、ローカルのLocalSettings.phpファイルにを設定することによって、付近用の別個のMediaWiki実装を使うことができます.  一例としてではウィキペディア英語版の記事について位置情報を使っています.  付近エンドポイントは、与えられた地理的位置に関連するコンテンツを検索するために使用されます.



外装の設定
既存のデスクトップ版サイトと並行して、MobileFrontend はモバイル用に整形されたウェブサイトを提供します. どんな外装にでもできます.

以下の外装は MobileFrontend と互換性があります:


 * Skin:Minerva Neue (安定版、WMF のウィキ群の既定の外装)
 * Skin:Vector (デスクトップ用の既定の外装、モバイルでは実験的なレスポンシブ モード)
 * Skin:Timeless (実験的な外装)
 * (responsive skin)
 * (responsive skin)



環境設定
を参照

All configuration options are detailed in the README.md file.



追加の調整
以下の互換性がある拡張機能を選択して追加すると、MobileFrontend を最大限に活用できます.


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



ローカルなカスタマイズ


CSSスタイル
モバイル向けテーマに CSS を適用するには、MediaWiki:Mobile.css を編集してください. これは MediaWiki:Common.css と同等のものです. スタイルシートが機能するためには、 を MediaWiki:Mobile.js に追加する必要がある場合があります.

MobileFrontend はグローバルなMediaWiki:Common.css も、どの利用者スタイルシートも読み込みません.



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

特定のページのモバイル版を表示したいけれど、サイト全体で拡張機能を有効にしたくない場合に、そのページのURLに文字列を追加することもできます.



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

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



モバイルビュー API
を参照してください.



拡張された action=parse
は以下の追加のパラメーターを受け付けます:


 * ページのHTMLをレンダリングしてモバイル形式で返します.
 * ページのHTMLをレンダリングしてモバイル形式で返します.


 * モバイル版のメインページ整形を適用する.
 * モバイル版のメインページ整形を適用する.

例:

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



セットアップ
拡張機能で何を実行したいかにもよりますが、事前コミットしたフックを実行するには、 を実行しphpコンポーザをインストールする必要があるかもしれません.



外部ウィキ上の記事を使ったテスト（ライブデータ）
を参照してください.



モバイルビューの利用


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



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

Using Apache (.htaccess or httpd.conf)
To set up a mobile domain, add the following rule to .htaccess or http.config

In LocalSettings.php

Now if you navigate to mobile.localhost (or your equivalent) you should see the mobile site.

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



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

<span id="Q:_How_do_I_add_HTML_to_the_Minerva_skin,_for_example_to_add_ads_or_additional_script_tags?">

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

<span id="Q:_The_extension_I_am_using_doesn&#039;t_seem_to_work_on_MobileFrontend._Why?">

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

<span id="Q:_I_upgraded_MobileFrontend_and_now_I&#039;m_getting_a_fatal_exception!">

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

<span id="Q:_After_upgrading_MediaWiki_I&#039;m_getting_an_exception_wgMFDefaultSkinClass_is_not_setup_correctly.">

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

<span id="For_Extension_Developers">

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

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

<span id="See_also">

関連項目

 * Wikimedia の MobileFrontend 設定ファイル
 * Commons:Category:MediaWiki extension MobileFrontend
 * Extension:MobileDetect
 * Extension:Progressive web application: turn any wiki into a mobile app
 * Extension:MobileDetect
 * Extension:Progressive web application: turn any wiki into a mobile app