This page is a translated version of the page Skin:Refreshed and the translation is 4% complete.
This page contains documentation for Refreshed 4. For documentation for Refreshed 3 and below, please see Special:PermanentLink/3442971.
MediaWiki皮肤手冊 - 分类
Refreshed
发行状态: 稳定版
描述 A clean, modern skin originally designed for use on Brickimedia, and now designed for all wikis
作者 Brickimedia (Adam Carter, George Barnick, MtMNC, ShermanTheMythran, Jack Phoenix, Drew1200, SirComputer, Seaside98, Samantha Nguyen, Lewis Cawte), MacFan4000
最新版本 4.0.7 (2023-04-03)
MediaWiki 1.39+
许可协议 GNU通用公共协议2.0或更新版本
下载
README.md
示例
Quarterly downloads 35 (Ranked 15th)
正在使用的公开wiki数 41 (Ranked 42nd)
作为默认皮肤使用的公开wiki数 19
翻译Refreshed皮肤(如在translatewiki.net可用)
问题 : 开启的任务 · 报告错误

Refreshed is a clean, modern skin. It was developed by the users of the Brickimedia wiki family, but it is also well suited for other wiki farms and standalone wikis. Refreshed uses responsive CSS to adapt to mobile devices, and it is fully compatible with modern smartphones and tablets.

The skin's appearance is easily and extensively customizable using CSS and LESS.

Refreshed 4.0.5 requires MediaWiki 1.35+. Previous versions of Refreshed 4 require MediaWiki 1.28+.

安裝

  • 下载文件,并将其放置在您skins/文件夹中的Refreshed目录内。
  • 将下列代码放置在您的LocalSettings.php 文件的底部:
    wfLoadSkin( 'Refreshed' );
    
  • If you are upgrading from Refreshed 4.x to a new version of the skin, be sure to back up your custom.less file before upgrading. Once the upgrade is complete, replace the new copy of custom.less with your old copy.
  •   完成 - 在您的wiki上打开Special:Version,以确认皮肤已成功安装。

配置

Choose how to style Refreshed

Refreshed 4 is built using LESS, so you can take advantage of mixins and other features to customize the skin extensively while writing few rules.

Method 1: edit custom.less

This is the simplest method to customize Refreshed using LESS.

Refreshed includes a starter LESS file located at refreshed/styles/screen/custom.less.

Edit this file to customize the skin.

Within this file you can access skin-specific LESS mixins available at refreshed/styles/screen/mixins-public.less.

You can also import wiki-wide mixins; see 手册:代码编写约定/CSS for more information.

If you use this method, remember to back up your custom.less file before upgrading.

Method 2: edit MediaWiki:Refreshed.css

You can customize Refreshed from within your wiki's interface by editing MediaWiki:Refreshed.css.

This allows users to customize the skin without going through the site's backend.

As an added bonus, the wiki's page history provides version control for your CSS.

Unfortunately, MediaWiki does not provide a LESS content model as of version 1.34.

As a result, if you want to customize the skin through the site interface, you must use plain old CSS instead of LESS.

Method 3: use Extension:Theme

You can customize Refreshed through Extension:Theme .

Register and set up a theme for Refreshed just as you would for any other skin.

This method lets you provide multiple customized versions of Refreshed that wiki users can pick from.

Also, if you use this method, you do not have to back up Refreshed's custom.less file every time you upgrade the skin.

You can use LESS, but note that your custom LESS files will be somewhere in the Theme extension's directory while Refreshed's skin-specific mixin file mixins-public.less will still be in the Refreshed skin's directory.

Therefore, if you want to use Refreshed's mixins in your custom LESS files, you will have to @import the mixin file from the Refreshed skin's directory (perhaps with a long relative URL).

Additional customization

Logo/wordmark

Unlike many other skins, Refreshed uses a wordmark instead of a large logo.

To adjust Refreshed's wordmark/mobile icon set $wgLogos[ 'wordmark' ] and $wgLogos[ 'icon' ] per the manual. When the values in $wgLogos aren't set, or if you are using an older version of Refreshed, the below interface messages are used instead (if they are set).

  • MediaWiki:Refreshed-this-wiki-wordmark - The URL of the wordmark displayed on the "big" and "medium" layouts of the skin. This wordmark is also displayed in the sidebar of the "small" layout of the skin.
  • MediaWiki:Refreshed-this-wiki-mobile-logo - The URL of the logo displayed on the "small" layout of the skin. A graphic with no text is recommended.


  维基管理员技巧: For optimal display on Refreshed's mobile skin, you should consider either using downscaled images or SVG images so that the logo does not display as blurry on "retina" (high PPI) mobile device screens

Wiki farm support

Refreshed was designed with wiki farms in mind.

By default, Refreshed only shows one wiki logo.

The skin can be configured to also show a dropdown with links to other wikis.

To add other links, edit MediaWiki:Refreshed-wiki-dropdown and add one line of the following form for each wiki in the farm.

* Wiki name|logo image URL|wiki URL

The dropdown appears in the header on the "big" and "medium" layouts of the skin.

In the "small" layout, the dropdown appears in the sidebar.

The third parameter, the wiki URL, defaults to the wiki's main page but can be customized with MediaWiki:Refreshed-this-wiki-url.

Header categories and the Explore dropdown

Refreshed 3.0 and above feature "header categories".

These are customizable dropdowns in the header that contain links to wiki pages.

To modify the header categories, edit MediaWiki:Refreshed-navigation and create a list similar to this:

* Category 1
** MediaWiki:Refreshed-navigation|Entry 1
** MediaWiki:Refreshed-navigation|Entry 2
** MediaWiki:Refreshed-navigation|Entry 3
** MediaWiki:Refreshed-navigation|Entry 4
* Category 2
** MediaWiki:Refreshed-navigation|Entry 1
** MediaWiki:Refreshed-navigation|Entry 2
** MediaWiki:Refreshed-navigation|Entry 3
** MediaWiki:Refreshed-navigation|Entry 4
* Category 3
** MediaWiki:Refreshed-navigation|Entry 1
** MediaWiki:Refreshed-navigation|Entry 2
** MediaWiki:Refreshed-navigation|Entry 3
** MediaWiki:Refreshed-navigation|Entry 4

Header categories appear in the "big" and "medium" layouts of the skin.

If the window is not wide enough to fit all of the header categories, the header categories are placed inside a single dropdown titled "Explore."

(To change the name of this dropdown, edit MediaWiki:Refreshed-explore.)

In the "small" layout of the skin, the header categories appear in the sidebar.

To display the header categories in a different language, go to MediaWiki:Refreshed-navigation/de where de is the language code and create the same list in the desired language.

Advertisements

Refreshed does not contain advertisements by default, but you can configure it to show Google Ads by placing the following code in your LocalSettings.php file.

function showRefreshedAdvert( &$footerExtra ) {
	$footerExtra = '
		<div id="advert">
			<p>' . wfMessage( 'refreshed-advert' )->escaped() . '</p>
			<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
			<!-- Refreshed ad -->
			<ins class="adsbygoogle"
				style="display:inline-block;width:728px;height:90px"
				data-ad-client="ca-pub-9543775174763951"
				data-ad-slot="7733872730"></ins>
			<script>
				(adsbygoogle = window.adsbygoogle || []).push({});
			</script>
		</div>';
	return true;
}
$wgHooks['RefreshedFooter'][] = 'showRefreshedAdvert';

The values of data-ad-client and data-ad-slot should match the values that Google gave you.

To make your ads responsive across devices, add the following CSS to MediaWiki:Refreshed.css, or MediaWiki:Global-refreshed.css if you are on a wiki farm setup. This requires installing GlobalCssJs.

(As of Refreshed 4, you can also use LESS to customize how the ads display at different window sizes.)

@media (max-width: 500px) {
	.adsbygoogle {
		width: 320px;
		height: 50px;
	}
}

@media (max-width:799px) {
	.adsbygoogle {
		width: 480px;
		height: 60px;
	}
}

@media (min-width: 800px) {
	.adsbygoogle {
		width: 728px;
		height: 90px;
	}
}

Echo

Refreshed 4 supports Echo natively.

User avatars

Refreshed autodetects the presence of Extension:社交档案 and loads users' avatars if they are enabled.

Default avatars

If SocialProfile avatars are not enabled, Refreshed displays a generic icon by your username (or by the "log in" dropdown if you are not signed in).

You can customize these generic icons by editing the following pages.

  • MediaWiki:Refreshed-icon-logged-in - The URL to a default avatar for logged-in users.
  • MediaWiki:Refreshed-icon-logged-out - The URL to a default avatar for logged-out users.

Page status indicators

Refreshed 3 and above supports 頁面狀態指示器 .

By default all page status indicators are hidden on the "small" layout of the skin, but you can whitelist individual indicators with the following CSS:

#mw-indicator-name { /* replace "name" with the indicator's "name" value */
	display: inline-block;
}

图库

Refreshed 4

Refreshed 3 and below