스킨:미네르바 노이어

From mediawiki.org
This page is a translated version of the page Skin:Minerva Neue and the translation is 7% complete.
이 스킨은 미디어위키 1.38 이상에서 포함됩니다. 따라서 다시 다운로드하지 않아도 됩니다. 하지만 여전히 제공되는 별개의 지침을 따라야 합니다.
미디어위키 스킨 설명서 - 분류
OOjs UI icon layout-ltr.svg
Minerva Neue (Minerva)
출시 상태: 안정
Screen Shot of MinervaNeue mediawiki skin in 2020.png
호환성 정책 스냅샷은 미디어위키와 함께 릴리스됩니다. Master is not backwards compatible.
미디어위키 1.30+
라이선스 GNU General Public License 2.0 or later
다운로드
예시 Example on this wiki
$2 스킨 번역 (translatewiki.net에서 가능한 경우)
Check usage and version matrix;
Vagrant role minerva
이슈 : 미해결 작업 · 버그 보고
Minerva is a responsive screen and will adapt to mobile devices.

Minerva is the skin that serves mobile traffic for Wikimedia projects across the world. Compared to other skins such as 스킨:벡터 , it provides a much simpler user interface and is much more aggressive about optimizing for performance so that it can cater for mobile users.

It is optimized for use with the 확장기능:모바일 프론트엔드 extension (which is done by setting wgDefaultMobileSkin to 'minerva'), but, since MediaWiki 1.35, Minerva Neue can also be used without MobileFrontend. For earlier MediaWiki versions, MobileFrontend is required.

설치

  • Vagrant 를 사용하고 있는 경우에는, vagrant roles enable minerva -p로 설치해주세요

수동 설치

  • 파일을 다운로드하고 MinervaNeue 폴더를 skins/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 LocalSettings.php의 말미에 추가합니다:
wfLoadSkin( 'MinervaNeue' );
$wgDefaultSkin = 'minerva';
  • Yes 완료 - 위키의 Special:Version에 이동해서, 스킨이 올바르게 설치된 것을 확인합니다.
  • Note: Setting $wgDefaultSkin = 'minerva' will make Minerva your default skin even in desktop view.

Ignore this line and instead use $wgMFDefaultSkinClass = 'SkinMinerva'; if you want only MobileFrontend to use the Minerva skin.

Minerva in preferences

Make sure to call wfLoadSkin after wfLoadExtension.

MobileFrontend integration

With MobileFrontend integrated (mobile mode) the Minerva experience will be enhanced to include various other features including:

  • Red link edit confirmation
  • Reference pop-up drawer
  • An enhanced search
  • Better integration on mobile with many popular Wikipedia-style templates.

To benefit from these:

Make mobile Minerva behave like desktop Minerva

When MobileFrontend is installed, Minerva is modified to behave in a simplified mode. If you would like Minerva to behave more like the desktop version add the following code to LocalSettings.php:

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


설정

Configuration is listed in the Minerva readme in your local download or online.

Recently deprecated configuration

  • $wgMinervaCountErrors - previously used to count errors via statsd. In the unlikely event you were using it as a 3rd party please refer to Extension:WikimediaEvents for client side error logging.


메뉴 설정

Certain URLs in the main menu can be tweaked. These include:

Certain menu items will be enabled automatically when the relevant extension is added.

Desktop vs mobile modes


MobileFrontend provides additional capabilities that are not available in MediaWiki core. You can compare desktop vs mobile mode.

When operating in mobile mode the following features are available:

  • Sections can be collapsed and expanded.

Expanded sections are memorized in the browser's local storage.

  • The menu contains different options depending on the current mode, e.g. Special:Preferences is available on desktop
  • MediaWiki:Mobile.css (for mobile mode) or MediaWiki:Common.css (for desktop mode) will be loaded

The desktop mode of the site is experimental. Bug reports and patches are appreciated.

When operating in desktop mode there are various issues that we are working towards fixing. Your patches and help are welcomed.

Questions and answers

If you have a question not answered by the page – please feel free to use the talk page to raise them.

What do I get when I install MobileFrontend?

Minerva works without MobileFrontend but installing MobileFrontend will provide several enhancements – notably reference and red link pop-up drawers, and a mobile optimized search and custom editor. These optimizations will apply to the desktop and mobile version. Currently it is not possible to disable the mobile view link but patches to that effect will gladly be accepted!

I maintain an extension, how can I integrate with Minerva?

How should I target styles to Minerva?

If the extension includes any UI, when testing your extension with Minerva, it's important to check if your extension works or degrades acceptably on break points. For testing purposes, Minerva operates on several breakpoints: 320px (@width-breakpoint-mobile), 720px (@width-breakpoint-tablet) and 1000px (@width-breakpoint-desktop). Your extension is expected to adapt to these breakpoints using appropriate media queries. It is acceptable for a feature to disable altogether, provided it gives the user feedback where necessary e.g.

@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. */
}

Normally it's acceptable to use media queries for your extension and this will benefit all skins, however in some cases you may need Minerva specific behaviour. If so you can use Manual:$wgResourceModuleSkinStyles to define styles.

How can I add items to Minerva menus ?

The Minerva menu system is currently bespoke and does not work like other skins. We plan to fix this eventually so that Minerva makes use of the standard hook for modifying menus - Manual:Hooks/SkinTemplateNavigation::Universal. The work here is tracked in phab:T291568. If you would like to add menu items in the mean time, please use the MobileMenu hook.