Help:Template (Русский)
Шаблоны MediaWiki позволяют создать именованный кусок викитекста, который затем можно будет помещать на любой странице. Это позволяет сделать код статей проще, а также способствует их единообразному оформлению и упрощает поддержку. В основном шаблоны используются для включения в статью отдельных элементов форматирования, например, блоков или таблиц.
Использование
Шаблон можно включить в статью следующим кодом:
{{Template name}}
Большинство шаблонов принимают дополнительные параметры. На примере Template:Note (Русский):
{{Note (Русский)|Текст примечания.}}
что дает в результате:
Некоторые шаблоны используют именованные параметры, например Template:hc:
{{hc|head=/etc/rc.local|output=exit 0}}
результат:
/etc/rc.local
exit 0
Общий формат следующий:
{{Имя шаблона|параметр1|параметр2|...|параметрN}}
Инструкции по использованию шаблонов как правило можно найти на их страницах.
Стиль
- Следует указывать имя шаблона тем же регистром, что используется в примерах на их страницах. Например,
{{Pkg|...
и{{ic|...
— правильно, а{{pkg|...
и{{Ic|...
— нет. - Вокруг имени шаблона не должно быть пробелов:
{{Имя шаблона|...
— правильно, однако, например{{ Имя шаблона |...
— нет. - Шаблоны не должны быть включены в какую-либо категорию.
Экранирование недопустимых символов
Некоторые символы недопустимы внутри шаблонов, так как воспринимаются как часть вики-разметки. Обычно, это случается с "=" (знак равенства) и "|" (вертикальная черта). Решения этой проблемы указаны ниже.
{{!}}
.Именованные параметры
Если проблема только лишь со знаками равенства, рекомендуемым решением является явным образом определить параметры шаблона, указав их имена либо порядковые номера.
Пример: {{Tip (Русский)|1=https://archlinux.org/?foo=bar}}
Результат:
Это очень полезно для:
- Определений переменных.
- Внешних ссылок, содержащих в себе знак "=".
- Примеров консольных команд.
- Строк кода.
Пробельные символы (в том числе символы переноса строки) автоматически удаляются с начала и с конца значений именованных параметров. Чтобы сохранить их, начните значение параметра с тега <nowiki/>
.
Пример:
{{Tip (Русский)|1=<nowiki/> * https://archlinux.org/?foo=bar * https://archlinux.org/?foo=baz }}
Результат:
Несколько параметров
- Используя позиционные параметры
1
и2
{{hc|1=$ echo "="|2==}}
Результат:
$ echo "="
=
- Используя именованные параметры
head
иoutput
{{hc|head=$ echo "="|output==}}
Результат:
$ echo "="
=
Теги nowiki
Если проблема вызвана другими символами кроме "=", например, "}", рекомендуемым решением является обернуть параметр целиком тегами <nowiki>
. Этот способ позволяет экранировать все возможные недопустимые символы, однако он полностью отключает всю разметку внутри тегов. Например:
{{Tip (Русский)|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}
Оборачивание только проблемных частей (единичных символов) в теги <nowiki>
также, конечно, будет работать, однако это мешает восприятию кода страницы. Так следует делать только тогда, когда требуется обеспечить правильное отображение разметки, например, ссылок или других шаблонов:
{{Tip (Русский)|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}
foo
HTML сущности
Замена проблемных символов их HTML-сущностями также работает, но это может заметно усложнить восприятие кода страницы. Рекомендуется воздержаться от их использования кроме тех случаев, когда вышеперечисленные приемы работают неудовлетворительно. Пример:
{{Tip (Русский)|= | {{ }}}}
Создание
- Пространство имён Template частично защищено. Только автоподтверждённые участники могут создавать или изменять шаблоны.
- Перед созданием шаблона обязательно обсудите свою идею на странице Help talk:Template.
- Создавайте только шаблоны, уместные для использования в ArchWiki. Если вы собираетесь создать очень специфичный шаблон, который сможет быть использован лишь на ограниченном количестве страниц, скорее всего, это плохая идея.
- Создавайте простые и понятные шаблоны. Помните главный принцип философии Arch: "будь проще, тупица"!
Следующий общий пример следует использовать в качестве основы при создании шаблонов для обеспечения единообразия и упрощения их использования и редактирования:
<noinclude> {{Template}} Здесь краткое описание шаблона == Использование == <nowiki>{{Имя шаблона|параметр1|параметр2|...|параметрN}}</nowiki> == Пример == {{Имя шаблона|параметр1|параметр2|...|параметрN}}</noinclude><includeonly>Код шаблона располагается здесь...</includeonly>
Начать необходимо с создания страницы шаблона. Для этого просто перейдите по ссылке Template:Имя шаблона (разумеется, заменив Имя шаблона
нужным вам именем) отредактируйте страницу, и добавьте соответствующий викитекст.
Список шаблонов
Шаблоны, которые можно напрямую использовать в русскоязычных статьях на ArchWiki перечислены ниже. По ссылкам вы найдете инструкции по использованию каждого из шаблонов. Полный список всех шаблонов вы найдете на страницах Special:AllPages/Template:, Special:PrefixIndex/Template: или Special:MostLinkedTemplates.
Тестирование
Шаблоны состояния статьи
Эти шаблоны следует добавлять в начале статей или разделов. Смотрите также Help:Стиль#Шаблоны состояния статьи.
Переводчики также должны прочитать правила использования шаблонов в ArchWiki:Translation Team (Русский).
Страницы, отмеченные шаблонами состояния статей, отслеживаются в Category:Maintenance и в ArchWiki:Statistics#Maintenance statistics.
Только для страниц на английском:
Имя | Использование | Параметры |
---|---|---|
Template:Style | Для содержимого, имеющего проблемы с языком, вики-разметкой или стилем. | 1 — причина, 2 — (опционально) страница обсуждения, section — (опционально) раздел на странице обсуждения по умолчанию
|
Template:Accuracy | Неверное, вводящее в заблуждение или сбивающее с толку содержимое. | |
Template:Expansion | Неполное содержимое. | |
Template:Out of date | Устаревшее содержимое. | |
Template:Remove | Нерелевантное или бесполезное содержимое. | |
Template:Archive | Устаревшие страницы. | |
Template:Laptop style | Страницы ноутбуков, не соответствующие правилам страниц ноутбуков. | |
Template:Merge | Содержимое частично совпадает с содержимым другой страницы. | 1 — целевая страница, 2 — причина, 3 — (опционально) страница обсуждения, section — (опционально) раздел на странице обсуждения по умолчанию
|
Template:Move | Переименование страницы, перемещение раздела в другую статью. | |
Template:Redirect | Перенаправление на другую статью. | |
Template:Unsupported | Пользовательские страницы, не поддерживаемые Arch Linux. | 1 — дата последней проверки автором страницы
|
Для страниц на русском:
Имя | Использование | Параметры |
---|---|---|
Template:Translateme (Русский) | Незавершённые переводы. | 1 — причина, 2 — (опционально) страница обсуждения, section — (опционально) раздел на странице обсуждения по умолчанию
|
Template:Bad translation (Русский) | Переводы, имеющие проблемы. | |
Template:TranslationStatus (Русский) | Статус перевода. | 1 — название оригинальной статьи, 2 — дата перевода (формат 1 января 2022 ), 3 — номер ревизии английской страницы, для которой выполнен перевод
|
Шаблоны блока "Ссылки по теме"
Шаблоны форматирования кода
Шаблоны информационных блоков
Для использования только в черновиках на страницах обсуждения:
Прочие шаблоны
- Template:App
- Template:Broken package link (Русский)
- Template:Broken section link (Русский)
- Template:Bug
- Template:Committed identity
- Template:Dead link (Русский)
- Template:Lowercase title
- Template:man
- Template:Unsigned (Русский)
Шаблоны пакетов
Шаблоны ячеек таблиц
Выравнивание текста:
Имя | Выравнивание | Вики-разметка | Результат |
---|---|---|---|
Template:C | по центру | {{C|текст}} |
текст |
Template:L | слева | {{L|текст}} |
текст |
Фоновый цвет:
Имя | Цвет | Вики-разметка | Результат |
---|---|---|---|
Template:R | красный | {{R|текст}} |
текст |
Template:O | оранжевый | {{O|текст}} |
текст |
Template:Y | жёлтый | {{Y|текст}} |
текст |
Template:G | зелёный | {{G|текст}} |
текст |
Template:B | синий | {{B|текст}} |
текст |
Template:V | фиолетовый | {{V|текст}} |
текст |
Template:Grey | серый | {{Grey|текст}} |
текст |
Часто используемые тексты:
Имя | Вики-разметка | Результат |
---|---|---|
Template:Да | {{Да}} |
Да |
{{Да|https://wiki.archlinux.org/}} |
Да | |
Template:Нет | {{Нет}} |
Нет |
{{Нет|https://wiki.archlinux.org/}} |
Нет | |
Template:- | {{-}} |
– |
| colspan=2 {{Да}}
.