Skin:Lakeus

From mediawiki.org
Jump to navigation Jump to search
MediaWiki skins manual - category
OOjs UI icon layout-ltr.svg
Lakeus
Release status: stable
SkinLakeus.png
Author(s)
  • Lakejason0
  • Light beacon
  • Dianliang233
  • Winston Sung
  • ...
Latest version 1.0.18 (2021-10-16)
Compatibility policy Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki 1.36+
License GNU General Public License 3.0 or later
Download
Example Example on MediaWiki Skins Wiki
Parameters
  • $wgLakeusShowRepositoryLink
  • $wgLakeusSiteNoticeHasBorder
Translate the Lakeus skin if it is available at translatewiki.net
Check usage and version matrix;

Lakeus is a skin that aims to provide a simple but all-functional experience. It's named after a character in the novel of one of the authors, Lakejason0.

Installation[edit]

  • Download and place the file(s) in a directory called Lakeus in your skins/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
wfLoadSkin( 'Lakeus' );
  • Yes 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( 'Lakeus' );, you need to use:

require_once "$IP/skins/Lakeus/Lakeus.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.)

Features[edit]

  • Simple but all-functional (at least most of them should work).
  • With no-JavaScript support.
  • Customization through CSS variables.
  • Responsive design. Should work with desktop and tablet; on very narrow phones the sidebar menu might be too wide to close.

Planned Features[edit]

Notes[edit]

  • The skin should be no-JavaScript compatible. Several handy features may not be available though.
  • The skin made a dedicated menu for site that uses a language with LanguageConverter variants (e.g. Chinese (zh) and Serbian). When no variants available, the menu should be invisible.
  • RTL support hasn't been tested well, but main features are confirmed RTL compatible (e.g. sidebar menus).

Customization[edit]

CSS variables[edit]

Lakeus supports customization through CSS variables. Below is the default setting of CSS variables; modify these settings and put the result into your Lakeus.css:

:root {
  --background-color-base: white;
  --background-color-article: white;
  --background-color-content: white;
  --background-color-footer: #eee;
  --background-color-toggle-list: white;
  --background-color-portlet-body: white;
  --background-color-toggle-list-card: #eee;
  --background-color-toggle-list-item-hover: #eee;
  --background-color-toggle-list-item-focus: #ccc;
  --background-color-portlet-item-hover: #eee;
  --background-color-portlet-item-focus: #ccc;
  --background-color-edit-options: #eee;
  --background-color-search-suggestions: #fff;
  --background-color-search-suggestions-current: #1d5492;
  --border-color-edit-options: #c8ccd1;
  --border-color-content: #ccc;
  --border-color-toggle-list: #ddd;
  --border-color-search-suggestions: #c8ccd1;
  --subheader-color-toggle-list: rgba( 0, 0, 0, 0.6 );
  --logo-text-color-toggle-list: inherit;
  --color-search-suggestions-text: #000;
  --color-search-suggestions-text-current: #fff;
  --color-header: white;
  --color-base: #54595d;
  --color-gray: #a2a9b1;
  --color-gray-2: #eaecf0;
  --color-link: #0645ad;
  --color-link--visited: #0b0080;
  --font-family: 'Roboto', -apple-system, blinkmacsystemfont, 'Segoe UI', 'Oxygen', 'Ubuntu', 'Cantarell', 'Helvetica Neue', sans-serif;
  --elevation: 0 2px 2px rgba( 0, 0, 0, 10% );
  --mask-background: rgba( 0, 0, 0, 0.8 );
}

For example, to change the header's color to a light blue (e.g. #4FC3F7), it would be:

:root {
  --color-header: #4FC3F7;
}
Your CSS may not work in several special pages (like Preferences); it's an intended behavior of MediaWiki core due to security concerns, but site admins could set $wgAllowSiteCSSOnRestrictedPages to true to bypass it after understanding the risks.

Parameters[edit]

Parameter Type Default Description
$wgLakeusShowRepositoryLink Boolean true Determines whether to show the link to the skin's repository in the footer.
$wgLogos For now, only icon and wordmark are recognized; keys like svg, 1x, 1.5x or 2x are not used by the skin. Notice that other skins may utilize the image provided by icon AND other keys as well, so do not rely on the key to provide a icon only for this skin.
$wgLakeusSiteNoticeHasBorder Boolean false Determines whether to add a skin provided border to site notice. Enabling it can be useful for plain text notices, but if you've already got a border in your site notice content, you can leave it disabled.