Skin:Minerva Neue

Other languages:
Deutsch • ‎English • ‎Tiếng Việt • ‎Türkçe • ‎español • ‎français • ‎português • ‎português do Brasil • ‎русский • ‎বাংলা • ‎中文 • ‎日本語 • ‎한국어
MediaWiki skins manual - category
OOjs UI icon layout-ltr.svg
Minerva Neue (Minerva)
Release status: stable
Screen Shot of MinervaNeue mediawiki skin in 2020.png
Compatibility policy Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki 1.30+
License GNU General Public License 2.0 or later
Download
Example Example on this wiki
Translate the Minerva Neue skin if it is available at translatewiki.net
Check usage and version matrix;
Vagrant role minerva
Issues : Open tasks · Report a bug
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 Vector , it provides a much more simplistic 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 MobileFrontend as the wgDefaultMobileSkin but at the time of writing (current master and 1.35 release) this is a soft dependency and it will function without the extension installed. If using the 1.34 release or earlier it is a hard dependency.

InstallationEdit

  • If using Vagrant , install with vagrant roles enable minerva -p

Manual installation

  • Download and place the file(s) in a directory called MinervaNeue in your skins/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
wfLoadSkin( 'MinervaNeue' );
$wgDefaultSkin = 'minerva';
  •   Done - Navigate to Special:Version on your wiki to verify that the skin is successfully installed.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing skins using wfLoadSkin(), since MediaWiki 1.25. If you need to install this skin in earlier versions, instead of wfLoadSkin( 'MinervaNeue' );, you need to use:

require_once "$IP/skins/MinervaNeue/MinervaNeue.php";

(To run a skin on an earlier release, you may need to download the version of it tagged for that release from Special:SkinDistributor.)

  • 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 integrationEdit

With MobileFrontend integrated 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:

ConfigurationEdit

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

Recently deprecated configurationEdit

  • $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.

Configuration of menusEdit

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 modesEdit


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:

  • Core workflows such as editing and talk will trigger JavaScript based workflows. This is provided by Extension:MobileFrontend . See more for details.
  • 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 skin will link to pages optimized for mobile provided by MobileFrontend if enabled. See Extension:MobileFrontend for more information. e.g. Special:Watchlist (compare desktop vs mobile)
  • In mobile view, navigation bars and side bars are hidden by default, as described in their documentation.

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 answersEdit

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?Edit

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!