Jump to content
From ArchWiki
Состояние перевода: На этой странице представлен перевод статьи 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 (Русский)|&#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

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

- Template:Template
- MetaWikimedia: Help:Template

Category:

- Help (Русский)