Расширение:CSS

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

CSS Статус релиза: стабильно
Реализация	Функция парсера
Описание	Предоставляет функцию парсера для добавления CSS-файлов, статей или inline-правил в статьи
Автор(ы)	Aran Dunkley Rusty Burchfield
Последняя версия	3.5.0
MediaWiki	>= 1.43.0
Параметры $wgCSSIdentifier
Используемые хуки ParserFirstCallInit RawPageViewBeforeOutput
Licence	GNU General Public License 2.0 or later
Скачать	Скачать расширение Git [?]: репозиторий (GitHub) Обзор кода Gerrit журнал Git-коммитов Download source tarball
Пример	organicdesign.nz
Переведите расширение CSS, если оно доступно на translatewiki.net
Проблемы	Открытые задачи · Сообщить об ошибке

Расширение CSS позволяет подключать таблицы стилей к конкретным статьям. CSS-код может быть взят из другой статьи, файла или задан напрямую в виде правил внутри парсер-функции.

Использование

Например, если у вас есть статья с CSS-стилями под названием «MyStyles.css», которая содержит стили, предназначенные для использования со статьёй «MyFancyUserPage», вам следует добавить в последнюю следующий синтаксис функции парсера:

{{#css:MyStyles.css}}

Если же «MyStyles.css» — это файл в директории /wiki/skins, он подключается так, как показано ниже. Учтите, что путь к файлу должен быть абсолютным и начинаться со слеша, чтобы отличить его от заголовка статьи.

{{#css:/skins/MyStyles.css}}

В качестве альтернативы, CSS-правила могут быть прописаны напрямую внутри функции парсера (inline), как показано в следующем примере:

{{#css:
  body {
    background: yellow;
    color: red;
    font-size: 1.25rem;
  }
}}

Установка

• Скачайте и распакуйте файл(ы) в папку с названием CSS в вашей папке extensions/.
  Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CSS
  

• Если и только если устанавливаете из git, запустите Composer для установки зависимостей PHP, запустив composer install --no-dev в каталоге расширений. (Смотрите T173141 о возможных осложнениях.)
• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'CSS' );
  

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

Конфигурация

При необходимости вы можете указать базовый URL-адрес для внешних файлов.

$wgCSSPath = false;  # По умолчанию, относительно $wgScriptPath
$wgCSSPath = '';  # Относительно корня вашего сервера
$wgCSSPath = 'https://example.org/stylesheets';  # Относительно другого сайта

Советы

Изменение цвета или фона определённой страницы

Использование функции парсера для подключения CSS с другой страницы не позволяет изменить цвет текста или фона страницы; однако использование функции парсера напрямую на этой же странице позволяет менять фон. Для решения этой проблемы можно загрузить CSS через включение, что исключает проблему с невозможностью загрузки изменений фона страницы.

См. также

• Extension:NewPageCSS
• Расширение:TemplateStyles - аналогичное расширение, которое очищает CSS-код и хранит его на отдельных страницах.