Help:Template (Русский)
Шаблоны MediaWiki позволяют создать именованный кусок викитекста, который затем можно будет помещать на любой странице. Это позволяет сделать код статей проще, а также способствует их единообразному оформлению и упрощает поддержку. В основном шаблоны используются для включения в статью отдельных элементов форматирования, например, блоков или таблиц.
Использование
Шаблон можно включить в статью следующим кодом:
{{Template name}}
Большинство шаблонов принимают дополнительные параметры. На примере Template:Note (Русский):
{{Note (Русский)|Текст примечания.}}
что дает в результате:
Некоторые шаблоны используют именованные параметры, например Template:hc:
{{hc|head=/etc/rc.local|output=exit 0}}
результат:
/etc/rc.local
exit 0
Общий формат следующий:
Инструкции по использованию шаблонов как правило можно найти на их страницах.
Стиль
- Следует указывать имя шаблона тем же регистром, что используется в примерах на их страницах. Например, и — правильно, а и
{{Ic|...
— нет. - Вокруг имени шаблона не должно быть пробелов:
{{Имя шаблона|...
— правильно, однако, например — нет. - Шаблоны не должны быть включены в какую-либо категорию.
Экранирование недопустимых символов
Некоторые символы недопустимы внутри шаблонов, так как воспринимаются как часть вики-разметки. Обычно, это случается с "=" (знак равенства) и "|" (вертикальная черта). Решения этой проблемы указаны ниже.
Именованные параметры
Если проблема только лишь со знаками равенства, рекомендуемым решением является явным образом определить параметры шаблона, указав их имена либо порядковые номера.
Пример:
Результат:
Это очень полезно для:
- Определений переменных.
- Внешних ссылок, содержащих в себе знак "=".
- Примеров консольных команд.
- Строк кода.
Пробельные символы (в том числе символы переноса строки) автоматически удаляются с начала и с конца значений именованных параметров. Чтобы сохранить их, начните значение параметра с тега .
Пример:
Результат:
Несколько параметров
- Используя позиционные параметры и
2
Результат:
$ echo "="
=
- Используя именованные параметры и
Результат:
Теги nowiki
Если проблема вызвана другими символами кроме "=", например, "}", рекомендуемым решением является обернуть параметр целиком тегами . Этот способ позволяет экранировать все возможные недопустимые символы, однако он полностью отключает всю разметку внутри тегов. Например:
Оборачивание только проблемных частей (единичных символов) в теги также, конечно, будет работать, однако это мешает восприятию кода страницы. Так следует делать только тогда, когда требуется обеспечить правильное отображение разметки, например, ссылок или других шаблонов:
{{Tip (Русский)|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}
HTML сущности
Замена проблемных символов их HTML-сущностями также работает, но это может заметно усложнить восприятие кода страницы. Рекомендуется воздержаться от их использования кроме тех случаев, когда вышеперечисленные приемы работают неудовлетворительно. Пример:
{{Tip (Русский)|= | {{ }}}}
Создание
- Пространство имён Template частично защищено. Только автоподтверждённые участники могут создавать или изменять шаблоны.
- Перед созданием шаблона обязательно обсудите свою идею на странице Help talk:Template.
- Создавайте только шаблоны, уместные для использования в ArchWiki. Если вы собираетесь создать очень специфичный шаблон, который сможет быть использован лишь на ограниченном количестве страниц, скорее всего, это плохая идея.
- Создавайте простые и понятные шаблоны. Помните главный принцип философии Arch: "будь проще, тупица"!
Следующий общий пример следует использовать в качестве основы при создании шаблонов для обеспечения единообразия и упрощения их использования и редактирования:
Начать необходимо с создания страницы шаблона. Для этого просто перейдите по ссылке Template:Имя шаблона (разумеется, заменив нужным вам именем) отредактируйте страницу, и добавьте соответствующий викитекст.
Список шаблонов
Шаблоны, которые можно напрямую использовать в русскоязычных статьях на ArchWiki перечислены ниже. По ссылкам вы найдете инструкции по использованию каждого из шаблонов. Полный список всех шаблонов вы найдете на страницах Special:AllPages/Template:, Special:PrefixIndex/Template: или Special:MostLinkedTemplates.
Тестирование
- Template:Sandbox
- Template:Lorem Ipsum
Шаблоны состояния статьи
Эти шаблоны следует добавлять в начале статей или разделов. Смотрите также Help:Стиль#Шаблоны состояния статьи.
Переводчики также должны прочитать правила использования шаблонов в ArchWiki:Translation Team (Русский).
Страницы, отмеченные шаблонами состояния статей, отслеживаются в Category:Maintenance и в ArchWiki:Statistics#Maintenance statistics.
Только для страниц на английском:
Имя | Использование | Параметры |
---|---|---|
Template:Style | Для содержимого, имеющего проблемы с языком, вики-разметкой или стилем. | — причина, 2 — (опционально) страница обсуждения, — (опционально) раздел на странице обсуждения по умолчанию |
Template:Accuracy | Неверное, вводящее в заблуждение или сбивающее с толку содержимое. | |
Template:Expansion | Неполное содержимое. | |
Template:Out of date | Устаревшее содержимое. | |
Template:Remove | Нерелевантное или бесполезное содержимое. | |
Template:Archive | Устаревшие страницы. | |
Template:Laptop style | Страницы ноутбуков, не соответствующие правилам страниц ноутбуков. | |
Template:Merge | Содержимое частично совпадает с содержимым другой страницы. | — целевая страница, 2 — причина, — (опционально) страница обсуждения, — (опционально) раздел на странице обсуждения по умолчанию |
Template:Move | Переименование страницы, перемещение раздела в другую статью. | |
Template:Redirect | Перенаправление на другую статью. | |
Template:Unsupported | Пользовательские страницы, не поддерживаемые Arch Linux. | — дата последней проверки автором страницы |
Для страниц на русском:
Имя | Использование | Параметры |
---|---|---|
Template:Translateme (Русский) | Незавершённые переводы. | — причина, 2 — (опционально) страница обсуждения, — (опционально) раздел на странице обсуждения по умолчанию |
Template:Bad translation (Русский) | Переводы, имеющие проблемы. | |
Template:TranslationStatus (Русский) | Статус перевода. | — название оригинальной статьи, 2 — дата перевода (формат ), — номер ревизии английской страницы, для которой выполнен перевод |
Шаблоны блока "Ссылки по теме"
- Template:Related articles start (Русский)
- Template:Related
- Template:Related articles end
Шаблоны форматирования кода
- Template:ic
- Template:bc
- Template:hc
- Template:Text art
Шаблоны информационных блоков
- Template:Note (Русский)
- Template:Tip (Русский)
- Template:Warning (Русский)
Для использования только в черновиках на страницах обсуждения:
- Template:Comment
Прочие шаблоны
- 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:Pkg
- Template:Grp
- Template:AUR
Шаблоны ячеек таблиц
Выравнивание текста:
Имя | Выравнивание | Вики-разметка | Результат |
---|---|---|---|
Template:C | по центру | {{C|текст}} | |
Template:L | слева |
Фоновый цвет:
Имя | Цвет | Вики-разметка | Результат |
---|---|---|---|
Template:R | красный | ||
Template:O | оранжевый | текст | |
Template:Y | жёлтый | ||
Template:G | зелёный | текст | |
Template:B | синий | ||
Template:V | фиолетовый | ||
Template:Grey | серый |
Часто используемые тексты:
Имя | Вики-разметка | Результат |
---|---|---|
Template:Да | Да | |
Template:Нет | {{Нет}} | |
Template:- |
Шаблоны категорий
- Template:Cat main
Смотрите также
- Template:Template
- MetaWikimedia: Help:Template