Extension:TemplateStylesExtender/ru

Справка по расширениям MediaWiki

TemplateStylesExtender Статус релиза: стабильно
Реализация	Расширение парсера
Описание	Extends Extension:TemplateStyles with new selectors
Автор(ы)	Octfxобсуждение
Последняя версия	1.2.0 (2023-07-19)
MediaWiki	1.39+
PHP	>=8.0
Composer	octfx/template-styles-extender
Лицензия	GNU General Public License 2.0 или позднее
Скачать	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net .
Параметры $wgTemplateStylesExtenderEnablePrefersColorScheme $wgTemplateStylesExtenderEnableCssVars $wgTemplateStylesExtenderEnableUnscopingSupport
Используемые хуки EditPage::attemptSave ParserFirstCallInit TemplateStylesPropertySanitizer TemplateStylesStylesheetSanitizer

The TemplateStylesExtender extension extends Расширение:TemplateStyles with new selectors and matchers.

Features

Add support for:

• CSS variables:

  Пример color: var( --color-base )

• image-rendering
• ruby-position
• ruby-align
• scroll-margin-* and scroll-padding-*
• @media (prefers-color-scheme: dark/light) media queries
• mask-image
• clamp
• revert / revert-layer
• aspect-ratio

Установка

• Download и распакуйте файл(ы) в папку с названием TemplateStylesExtender в вашей папке extensions/.
• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'TemplateStyles' );
  wfLoadExtension( 'TemplateStylesExtender' );
  

• Configure as required.
•  Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Настройка

Key	Описание	Пример	По умолчанию
$wgTemplateStylesExtenderEnablePrefersColorScheme	Flag to enable @media (prefers-color-scheme: dark/light) media queries	false	true
$wgTemplateStylesExtenderEnableCssVars	Flag to enable CSS vars	false	true
$wgTemplateStylesExtenderEnableUnscopingSupport	Flag to enable unscoping of CSS by users with editinterface permissions	true	false

Note CSS Vars

Currently using :root selectors won't work due to template styles prepending .mw-parser-output.

One possible fix is to wrap the entire content into a 'div' element and adding the declarations to this, e.g.

div#content-wrap {
   --padding: 10px
}

.content {
   padding: var( --padding )
}

Викитекст

<div id="content-wrap">
   <div class="content">
      The WikiText...
   </div>
</div>

Unscoping of CSS

Example: results in the CSS being scoped to .mediawiki instead of .mw-parser-output.

Including such a call in a page essentially limits editing to users with the editinterface right. You can alternatively include a call to a template that includes the styles.

См. также

• Расширение:TemplateStyles