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

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

Шаблоны 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}}

Результат:

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

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

Пробельные символы (в том числе символы переноса строки) автоматически удаляются с начала и с конца значений именованных параметров. Чтобы сохранить их, начните значение параметра с тега <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>}}
Совет: = | }} https://archlinux.org/ {{ic|foo}}

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

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

HTML сущности

Замена проблемных символов их HTML-сущностями также работает, но это может заметно усложнить восприятие кода страницы. Рекомендуется воздержаться от их использования кроме тех случаев, когда вышеперечисленные приемы работают неудовлетворительно. Пример:

{{Tip (Русский)|&#61; &#124; &#123;&#123; &#125;&#125;}}
Совет: = | {{ }}

Создание

Примечание:
  • Пространство имён 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: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 {{Да}}.

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

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