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

Состояние перевода: На этой странице представлен перевод статьи 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.

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

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

  • 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

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

This article is issued from Archlinux. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.