Help:Templates/ru

Шаблоны MediaWiki полезны для размещения одинаковых стандартных элементов (текста или форматирования) в других страницах.

Создание шаблонов
Шаблоны являются обычными вики-страницами, с той разницей, что их названия начинаются с префикса « » (« »), поэтому их можно создавать так же как обычные страницы.

Использование шаблонов
Шаблоны — это вики-страницы, используемые в других вики-страницах. Доступных способов использования три:
 * добавляет в страницу копию содержимого шаблона (страницы с именем Template:Name ). Обращение к шаблону производится каждый раз, когда производится извлечение использующей его страницы. Таким образом, если изменить шаблон, то отображение использующих его страниц тоже изменится.
 * заменяет данную строку содержимым шаблона в момент сохранения страницы. Таким образом, после сохранения в ней остается копия шаблона, которую можно будет изменять так же, как обычную wiki-разметку. После сохранения шаблон и страница редактируются независимо: изменение страницы не влияет на шаблон, изменение шаблона не влияет на страницу. Note: не стоит пользоваться данным способом, если вы хотите, чтобы изменения шаблона отображались в использующих его страницах.
 * включает шаблон в виде формы, отображающейся в использующей его странице, аналогично тому как действует тэг . Как и в первом случае, изменение шаблона изменяет то, что мы видим при отображении страницы.

Параметры в шаблонах
В шаблонах можно объявить параметры, либо как нумерованные  либо именованные.

Пример: Вы хотите оставлять подписи с благодарностью на страницах обсуждения других пользователей, с объяснением, за что вы благодарите. Вы можете создать Template:Thankyou/ru с текстом, аналогичным изображенному в таблице примеру.

Вставляя шаблон в страницу, укажите значения для его параметров, разделяя их символом (|):. Для именованных параметров используйте пары «имя=значение», разделяя их тем же символом (|):. Преимущество использования именованных параметров — гибкость порядка их указания и большая ясность в понимании их назначения, особенно когда параметров много. Если требуется изменить порядок нумерованных параметров, их следует упомянуть явно:.

Для параметров можно указать значения по умолчанию, т.е. значения, которые будут использоваться, если никакого значения не указано. Например:  будет присваивать значение «всё хорошее» параметру reason, если оно не будет указано в вызове шаблона явно.

Управление включением шаблонов
Тем, какая часть шаблона будет включаться в страницу, можно управлять с помощью тэгов  и .

Всё что находится между  и   будет обрабатываться и отображаться только если страница шаблона просматривается сама по себе.

Возможное применения данной возможности следующие:
 * отнесение шаблонов к категориям;
 * межъязыковые ссылки на похожие шаблоны на других языках;
 * пояснительный текст по использованию шаблона.

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

Замечание: Когда вы изменяете категории, добавляемые в страницу с использованием шаблонов, категоризация может не сработать сразу, так как она управляется.

Систематизация шаблонов
Для эффективного использования шаблонов нужно их легко находить и применять. Легче всего это обеспечить, поместив на страницу шаблона пример его использования. Например такой:

Использование
Позволяет давать ссылку на тему:

Таким образом редактор сможет просто скопировать пример и модифицировать его для своих нужд.

См. также

 * Help:External searches — пример необычного использования шаблонов.
 * Help:Magic words — функциональные вещи ("магические слова"), которые вы можете найти в некоторых шаблонах.
 * — встраиваемые страницы из отличающихся от.