Тема:Refreshed

На этой странице содержится документация по Refreshed 4. Для документации по Refreshed 3 и более ранним версиям, см. Special:PermanentLink/3442971.

Справка по темам оформления MediaWiki - категория

Refreshed Статус релиза: стабильный
Описание	Чистая и современная тема была изначально создана для Брикимедии (Brickimedia), но затем была открыта и для остальных.
Автор(ы)	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 General Public License 2.0 или позднее
Download	Download skin Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review README.md
Example	Brickimedia Example on Skins wiki Wikimedia Skins Lab BS01 Wiki (сильно настроена)
Hooks used EchoCanAbortNewMessagesAlert PageDeleteComplete PageSaveComplete
Hooks provided RefreshedFooter RefreshedInSidebar
Quarterly downloads	39 (Ranked 14th)
Public wikis using	41 (Ranked 42nd)
Public wikis using as default skin	19
Переведите тему оформления Refreshed, если он доступен на translatewiki.net
Issues :	Open tasks · Report a bug

Refreshed — чистая и современная тема оформления. 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 требуется MediaWiki 1.35+. Для предыдущих версий Refreshed 4 требуется MediaWiki 1.28+.

Установка

• Скачайте и распакуйте файл(ы) в папку с именем «Refreshed» в папке skins/ вашего сайта.
• Добавьте следующий код в ваш файл 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.
•  Готово - Перейдите на страницу 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.

Способ 1: изменить 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 Manual:Coding conventions/CSS#LESS for more information.

Если вы используете этот способ, не забудьте сделать резервную копию файла custom.less перед обновлением.

Способ 2: изменить 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.

Способ 3: использовать 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).

Дополнительная настройка

Логотип/водяной знак

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. Рекомендуется использовать графику без текста.

Совет для администраторов вики: 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.

Рекламные объявления

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 изначально поддерживает Echo.

Аватары пользователей

Расширение:СоциальныйПрофиль

Refreshed autodetects the presence of Расширение:СоциальныйПрофиль and loads users' avatars if they are enabled.

Аватары по умолчанию

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 - URL аватара по умолчанию для вошедших в систему пользователей.
• MediaWiki:Refreshed-icon-logged-out - URL аватара по умолчанию для вышедших из системы пользователей.

Индикаторы состояния страницы

Refreshed 3 и выше поддерживает Индикатор статуса страницы .

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

• 
  The "big" layout (window width > 1000px)
• 
  The "medium" layout (720px <= window width <= 1000px)
• 
  The "small" layout (window width < 720px)
• 
  The search bar in the "small" layout

Refreshed 3 и ниже

• 
  Refreshed 3
• 
  Refreshed 3's mobile design
• 
  Refreshed 3's tablet design
• 
  Refreshed's design prior to version 3.0