Skin:Minerva Neue

MediaWiki 外装マニュアル - カテゴリ

Minerva Neue (Minerva) リリースの状態: 安定
互換性の方針	MediaWiki とともにリリースされるスナップショット。 master には後方互換性がありません。
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	外装をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (Phabricator · GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー
例	本Wikiでの例
使用するフック ResourceLoaderRegisterModules SkinPageReadyConfig UserLogoutComplete FetchChangesList MobileFrontendBeforeDOM MobileFrontendFeaturesRegistration RequestContextCreateSkinMobile SpecialPageBeforeExecute ResourceLoaderGetConfigVars OutputPageBodyAttributes
提供するフック SkinMinervaOptionsInit MinervaNeueTalkPageOverlay
translatewiki.net で翻訳を利用できる場合は、Minerva Neue 外装の翻訳にご協力ください
Vagrant role	minerva
問題点 :	未解決のタスク · バグを報告

Minervaはレスポンシブスクリーンで、モバイル端末に適応します。

Minerva は、世界中のウィキメディアのプロジェクト群のモバイル端末への情報の往来を担う外装です。 ベクター 等の他の外装と比べ、非常に単純化されたユーザー インターフェイスを提供します。また、モバイル利用者の要求を満たすよう、パフォーマンスの最適化に非常に積極的です。

MobileFrontend 拡張機能で使えるよう最適化してありますが（wgMFDefaultSkinClass をミネルヴァ外装〈SkinMinerva〉に指定）、MediaWiki 1.35 以降は MobileFrontend 経由でなくても Minerva Neue 外装を使った場合も有効になります。 MediaWikiの以前のバージョンで使用するには、MobileFrontendが必要です。

インストール

この外装は MediaWiki 1.38 以降に同梱されているため、ダウンロードする必要はありません。 残りの設定手順は必ず従ってください。

• Vagrant を使用している場合は、vagrant roles enable minerva -p でインストールします

手動インストール

• ダウンロードして、ファイルを skins/ フォルダー内の MinervaNeue という名前のディレクトリ内に配置します。
• ファイル LocalSettings.php の末尾に以下のコードを追加してください:

  wfLoadSkin( 'MinervaNeue' );
  $wgDefaultSkin = 'minerva';
  

• 完了 - 自分のウィキの Special:Version に移動して、外装が正しくインストールされたことを確認してください。
• 注意：$wgDefaultSkin = 'minerva' を設定すると、デスクトップビューでも Minerva が既定の外装になってしまいます。 Minerva 外装を MobileFrontend 限定で使うように設定したい場合はこの行を無視し、代わりに $wgDefaultMobileSkin = 'minerva'; （最近のバージョンでは既定）を使用します。

個人設定で外装をMinervaに設定

wfLoadExtension の呼び出しの後に wfLoadSkin を呼び出していることを確認してください。

MobileFrontendとの連携

MobileFrontend の統合 (モバイル モード) により、Minerva の体験は以下のようなさまざまな機能で強化されます:

• 赤いリンクの編集確認
• リファレンスポップアップドロア
• 検索機能の強化
• ウィキペディアのテンプレートとの連携が向上。

これらの恩恵を受けるために

• MobileFrontend 拡張機能をダウンロードしてインストールしてください。

モバイル版Minervaをデスクトップ版Minervaのように動作させる

MobileFrontendをインストールすると、Minervaが簡易モードで動作するように修正されます。もし、Minervaをデスクトップ版のように動作させたい場合は、以下のコードを LocalSettings.php に追加してください。

$wgMinervaTalkAtTop['base'] = true;
$wgMinervaAdvancedMainMenu['base'] = true;
$wgMinervaPersonalMenu['base'] = true;
$wgMinervaHistoryInPageActions['base'] = true;
$wgMinervaOverflowInPageActions['base'] = true;
$wgMinervaShowCategories['base'] = true;

設定

ローカル環境にダウンロードすると、設定方法は Minerva の readme に示してあり、あるいはオンラインで参照可能です。

最近に非推奨になった設定

• $wgMinervaCountErrors - 以前はstatsd経由のエラーをカウントするために使用されていました。 万が一、サードパーティとして使用されていた場合は、クライアント側のエラーログについて拡張機能:WikimediaEvents を参照してください。

メニューの設定

メインメニューの特定のURLを調整できます。対象には以下が含まれます。

• おまかせ (MediaWiki:Randompage-urlを編集)
• ポータルの URL (MediaWiki:Portal-url経由の改良版編集モード)

関連する拡張機能を追加すると、特定のメニュー項目が自動的に有効になります。

• 近く (Extension:MobileFrontend 経由で提供)。

Items can be added to all menus except the navigation menu via the SkinTemplateNavigation::Universal hook.

Items in the main menu (hamburger menu / MediaWiki:Sidebar navigation) can currently only be modified as MediaWiki:Sidebar does not support the specification of icons.

$wgMinervaAdvancedMainMenu = [
	"base" => true,
	"loggedin" => true,
	 "amc" => true,
];
$wgMinervaPersonalMenu = [
	"base" => true,
	"loggedin" => true,
	 "amc" => true,
];
$wgMinervaOverflowInPageActions = [
	"base" => true,
	"loggedin" => true,
	 "amc" => true,
];
$wgHooks['SkinBuildSidebar'][] = function ( Skin $skin, &$bar ) {
    // Replace the random menu item with a history link
	foreach ( $bar['navigation'] as $key => $item ) {
		if ( $item['id'] === 'n-randompage' ) {
			$item['icon'] = 'history';
			$item['href'] = '/mylink';
			$item['msg'] = 'minerva-page-actions-history';
			$bar['navigation'][$key] = $item;
		}
	}
	// add item to toolbox
	$bar['TOOLBOX'][] = [
	    'id' => 't4',
		'icon' => 'custom 4',
		'text' => 'custom 4',
		'href' => '/wiki/Foo'
	];
};
$wgHooks['SkinTemplateNavigation::Universal'][] = function ( $t, &$s ) {
    // Add an action to the user menu
	$s['user-menu']['c1'] = [
		'icon' => 'custom 2',
		'text' => 'custom 2',
		'href' => '/wiki/Foo'
	];
	// add an action to the page actions (views) 
	$s['views']['c2'] = [
		'icon' => 'custom1',
		'text' => 'custom 1',
		'href' => '/wiki/Foo'
	];
};

Configuration of donation link

$wgMinervaDonateLink['base'] = true;

既定値は MediaWiki 1.35 true および 1.39 false。

When enabled a donate link will be added to the main menu. The donate link uses the sitesupport and sitesupport-url mediawiki messages.

アップグレードの注意点

以下に Minerva 関連の大きな変更をシステム管理者に向けてまとめてあるので、それぞれのウィキの更新に使ってください。

1.43

• $wgMinervaApplyKnownTemplateHacks was removed. Various styles relating to templates have been removed from MobileFrontend. The infobox styles were moved to Extension:WikimediaMessages . 3rd parties are advised to copy any styles they were using from the folder into MediaWiki:Common.css and enable common.css on mobile using $wgFSiteStylesRenderBlocking = true;

デスクトップモードとモバイルモード

関連項目: Reading/Web/改良版モバイル投稿モード

MobileFrontend は MediaWiki コアでは利用できない追加の機能を提供します。 デスクトップモードとモバイルモードで比較することができます。

モバイル モードで操作しているときには、以下の機能が利用可能です:

• 編集やトークなどのコアワークフローは、JavaScriptベースのワークフローを起動します。 Extension:MobileFrontend で提供されます。 詳細はこちらをご覧ください。
• 節を折り畳んだり展開したりすることができます。 拡張された部分は、ブラウザのローカルストレージに記憶されます。
• メニューは異なるオプションを含みます。例: デスクトップでは Special:Preferences (個人設定) が利用可能
• MediaWiki:Mobile.css (モバイル モード) または MediaWiki:Common.css (デスクトップ モード) が読み込まれます。
• 外装が有効な場合、MobileFrontend が提供するモバイル向けに最適化されたページにリンクされます。 詳細情報は Extension:MobileFrontend を参照してください。 例: Special:Watchlist (ウォッチリスト) (デスクトップとモバイルを比較してみてください)
• モバイル版表示だと解説文書に述べてあるとおり、ナビゲーション バーとサイド バーは既定で表示していません。

サイトのデスクトップ モードは実験用です。 バグを見つけた場合、パッチをいただけると助かります。

デスクトップモードで操作している場合、現在修正に向けて作業中の様々な問題が存在します。 あなたのパッチと支援を歓迎します。

質問と回答

このページで回答されていない質問がある場合、トークページを使用してお気軽に挙げてください。

MobileFrontendをインストールすると、何ができるのですか？ MobileFrontendをインストールしなくてもMinervaは動作しますが、MobileFrontendをインストールすると、いくつかの機能強化が行われます。特に、参照と赤いリンクのポップアップ引き出し、モバイルに最適化された検索とカスタムエディタが提供されます。 これらの最適化は、デスクトップ版とモバイル版に適用されます。 現在のところ、モバイルビューのリンクを無効にすることはできませんが、そのようなパッチは喜んでお受けします。

固有の拡張機能のメンテナですが、Minerva に統合する方法は？

Minerva の書式設定はどう処理する？

拡張機能に UI が1件でも含まれる場合は、自作の拡張機能を Minerva でテストする際に、その拡張機能がブレークポイントできちんと機能するか劣化するか、必ずきちんと確認願います。 テスト用であれば、Minerva は複数のブレイクポイントで動作可能です。 320px (@width-breakpoint-mobile), 720px (@width-breakpoint-tablet) and 1000px (@width-breakpoint-desktop). 自作の拡張機能はメディアの適切なクエリを採用して以下のようなブレイクポイントに適合させてください。 機能を完全に無効化することが認められる条件として、必要な場合に利用者のフィードバックを集めるものとし、例を挙げます。

@import 'mediawiki.skin.default.less';

@media screen and ( max-width: @width-breakpoint-tablet ) {
.myfeature { display: none; } /* not supported for mobile users */
.myfeature ~ .mobilewarning { display: block; } /* Show the warning message explaining why the feature was disabled. */
}

通常はすべての外装に有益である場合に自作の拡張機能にメディア クエリを用いることは容認されているものの、いくつかの場合においては Minerva 固有の挙動を設定してください。 それに適応するなら、書式設定に Manual:$wgResourceModuleSkinStyles を採用してください。

Minerva のメニューに項目を追加する方法は？

関連項目: Skin:Minerva_Neue/MobileMenu

Minerva メニューのシステムは現状でカスタマイズ化され、他の外装と挙動が異なります。これは時機を見て修正し、Minerva でもメニュー改変に標準のフック - Manual:Hooks/SkinTemplateNavigation::Universal を採用するように変える予定です。 ここで述べた作業は phab:T291568 で追跡中。 この期間にメニューに項目を追加したい場合は、MobileMenu フックを使ってください。