Шаблон:Осторожно

Материал из Amereco Wiki
(перенаправлено с «Шаблон:Caution»)
Перейти к навигацииПерейти к поиску

Осторожно: — именно так выглядит вызов без параметра: значок, подпись и текст остаются в одной строке.

Назначение

Шаблон отмечает действие, которое может привести к потере данных, поломке страницы или другим необратимым последствиям. Его смысл — «остановитесь и подумайте», поэтому не ставьте его там, где достаточно обычного пояснения.

По оформлению и строгости «Осторожно» равен Шаблон:Предупреждение: оба сообщения красные. Разница в поводе — «Осторожно» относится к конкретному опасному действию, «Предупреждение» говорит о состоянии страницы или темы в целом. Для спокойной справки есть Шаблон:Примечание.

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

Краткий режим

Без параметра шаблон печатает только значок и подпись «Осторожно:». Рамки нет, дальнейший текст продолжает тот же абзац.

{{Осторожно}} Кнопка удаляет страницу без возможности восстановления.

Результат:

Осторожно: Кнопка удаляет страницу без возможности восстановления.

Режим рамки

Если текст передан параметром, шаблон собирает отдельную коробку с рамкой. Такой вариант удобен для длинных предостережений: текст не обтекает значок и не смешивается с соседними абзацами.

{{Осторожно|1=Перед обновлением сделайте резервную копию базы: после сбоя восстанавливать будет уже не из чего.}}

Результат:

Осторожно:
Перед обновлением сделайте резервную копию базы: после сбоя восстанавливать будет уже не из чего.

Внутри рамки работает обычная разметка — списки, ссылки, выделение:

{{Осторожно|1=Не трогайте эти файлы вручную:
* config.php — перезаписывается при обновлении;
* cache/ — чистится только через служебную страницу.}}

Результат:

Осторожно:

Не трогайте эти файлы вручную:

  • config.php — перезаписывается при обновлении;
  • cache/ — чистится только через служебную страницу.

Параметры

Параметр Обязательный Описание
1 нет Текст предостережения. Есть текст — рисуется рамка, нет — работает краткий режим.
текст нет То же самое, но по имени. Пригодится, когда безымянный параметр читается хуже.
text нет Английский синоним параметра текст.

Шаблон берёт первый непустой параметр: сначала 1, затем текст, затем text. Пустое значение не перекрывает следующее, поэтому вызов {{Осторожно||текст=…}} тоже покажет рамку. Если все три пусты, включается краткий режим.

Знаки «=» и «|» внутри текста

Знак равенства MediaWiki считает границей между именем и значением параметра, поэтому текст со знаком «=» передавайте явно через 1=:

{{Осторожно|1=Значение debug=true оставлять в бою нельзя.}}

Вертикальную черту нужно экранировать — | или {{!}}, иначе она разорвёт вызов на два параметра.

Оформление

Все стили лежат в общем листе Шаблон:Сообщение/styles.css и подключаются автоматически. Шаблон использует классы amsg, amsg-caution, amsg-icon, amsg-label и amsg-body. Цвета взяты из переменных Codex с запасными значениями, поэтому тёмная тема поддерживается без отдельной настройки. Правьте оформление только в листе стилей — в самом шаблоне атрибутов style нет и быть не должно.

См. также