Help:Template (Русский)

Состояние перевода: На этой странице представлен перевод статьи Help:Template. Дата последней синхронизации: 26 декабря 2021. Вы можете помочь синхронизировать перевод, если в английской версии произошли изменения.

Ссылки по теме

• Help:Редактирование
• Help:Чтение
• Help:Стиль

Шаблоны 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|... — нет.
• Вокруг имени шаблона не должно быть пробелов: {{Имя шаблона|... — правильно, однако, например {{ Имя шаблона |... — нет.
• Шаблоны не должны быть включены в какую-либо категорию.

Экранирование недопустимых символов

Некоторые символы недопустимы внутри шаблонов, так как воспринимаются как часть вики-разметки. Обычно, это случается с "=" (знак равенства) и "|" (вертикальная черта). Решения этой проблемы указаны ниже.

Совет: Символ вертикальной линии (pipe) "|" можно экранировать с помощью магического слова {{!}}.

Именованные параметры

Если проблема только лишь со знаками равенства, рекомендуемым решением является явным образом определить параметры шаблона, указав их имена либо порядковые номера.

Пример: {{Tip (Русский)|1=https://archlinux.org/?foo=bar}}

Результат:

Совет: https://archlinux.org/?foo=bar

Это очень полезно для:

• Определений переменных.
• Внешних ссылок, содержащих в себе знак "=".
• Примеров консольных команд.
• Строк кода.

Пробельные символы (в том числе символы переноса строки) автоматически удаляются с начала и с конца значений именованных параметров. Чтобы сохранить их, начните значение параметра с тега <nowiki/>.

Пример:

{{Tip (Русский)|1=<nowiki/>
* https://archlinux.org/?foo=bar
* https://archlinux.org/?foo=baz
}}

Результат:

Совет:

• 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>}}

Совет: = | }} https://archlinux.org/ {{ic|foo}}

Оборачивание только проблемных частей (единичных символов) в теги <nowiki> также, конечно, будет работать, однако это мешает восприятию кода страницы. Так следует делать только тогда, когда требуется обеспечить правильное отображение разметки, например, ссылок или других шаблонов:

{{Tip (Русский)|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}

Совет: = | }} https://archlinux.org/ 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.

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

Тестирование

• Template:Sandbox
• Template:Lorem Ipsum

Шаблоны состояния статьи

Эти шаблоны следует добавлять в начале статей или разделов. Смотрите также 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: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	слева	{{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 {{Да}}.

Шаблоны категорий

• Template:Cat main

Смотрите также

• Template:Template
• MetaWikimedia: Help:Template