Тептар:Подстановка шаблонов

ТП:ПОДСТ

«Подст» (сокращение от «подставить»; также subst от англ. substitution) — инструкция тептар-синтаксиса; используется как префикс названия специального типа шаблонов — подстановочных шаблонов. Например, так: {{подст:имя шаблона}}. В отличие от обычных шаблонов, подстановочные шаблоны предназначены для непосредственной вставки их содержимого в текст статьи. Таким образом, сразу после сохранения страницы, её содержимое меняется.

Обычный шаблон раскрывается «на лету»: это значит, что при каждом обращении к странице, на которой установлен шаблон, сервер запрашивает содержимое шаблона и размещает его на странице при каждом просмотре. Если в шаблоне происходят какие-то изменения, то эти изменения коснутся всех страниц, в которые он уже вставлен.

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

ИспользованиеПравить

Чтобы раскрыть шаблон на странице, следует добавить к нему префикс «подст:» (либо «subst:») — например, {{подст:пример}} ({{subst:пример}}). Содержимое шаблона {{пример}} заменит собой этот код.

Делая подобную подстановку, желательно, чтобы в описании правки вы указали, какой шаблон вы ставите, чтобы другим пользователям было проще ориентироваться в ситуации. Также, создавая или редактируя шаблон, который обычно требует раскрытия с помощью префикса «подст:», желательно указать это в документации шаблона. Это поможет другим участникам понять, как шаблон должен быть использован.

Для предпросмотра кода, который появится после подстановки шаблона, его можно временно заключить в конструкцию {{subst:#tag:pre|{{подст:мой шаблон}}}}: после нажатия кнопки «Предварительный просмотр» отобразится подставленный код шаблона в таком же сером прямоугольнике (можно также использовать #tag:nowiki вместо #tag:pre). Не забудьте удалить лишние символы перед сохранением версии!

Преимущества подстановкиПравить

Шаблоны часто модифицируются или даже удаляются. Если шаблон представляет собой текст, который в дальнейшем не должен меняться, то следует использовать подстановку. В качестве примера можно привести шаблон {{Приветствие}}. Архивы страниц обсуждения участников должны содержать сообщение-приветствие в том виде, в каком участники его получили, а не текущее содержимое шаблона.
Если существует шаблон, который нужно модифицировать для единичного случая, не затрагивая при этом остальные страницы, где данный шаблон используется, а создавать новый шаблон смысла нет, то можно раскрыть нужный шаблон, а затем на той странице, где была произведена подстановка, подкорректировать код по своему усмотрению.
Раскрытие шаблонов позволяет новичкам просматривать тептар-текст, который содержится в шаблоне, что помогает быстрее освоить тептар-разметку.
Подстановка в целом может ускорить работу сайта, хотя это и является поводом для постоянных споров и дискуссий. Каждый раз, когда страница изменяется, сервер запрашивает текст с других страниц для каждого шаблона, который помещен на редактируемой странице. Эффект одного отдельно взятого шаблона невелик, но в сумме они создают значительную нагрузку на сервер, что значительно влияет на время загрузки страниц. Однако Brion Vibber, технический директор проекта (ответственный за техническую сторону работы Фонда Тептар), заявил:

«Правила» не должны заботиться о нагрузке на сервер, за исключением особых случаев; создание условий для решения основных нужд участников является нашей заботой.
Оригинальный текст (англ.)[показатьскрыть]

'Policy' should not really concern itself with server load except in the most extreme of cases; keeping things tuned to provide what the user base needs is our job.

— Brion Vibber

Недостатки подстановкиПравить

Единожды раскрытый шаблон становится просто частью кода страницы, на которой он был размещен, и больше никак не связан с исходным шаблоном. Из-за этого очень трудно найти страницы, в которые этот шаблон был помещён. Помещая в текст шаблона ссылку на шаблон, можно решить эту проблему.
Обновление исходного шаблона не затронет раскрытый шаблон. Тот останется таким же, каким был на момент подстановки.
Массовое раскрытие шаблонов с помощью ботов может привести к усиленной загрузке сервера.
Подстановка увеличивает размер статей в базе данных, а соответственно дамп базы данных.
Раскрытый шаблон может добавить на страницу большой кусок текста в тептар-разметке или HTML-кода, что может затруднить распознавание текста технически не подкованным участником.
Раскрытый шаблон может привести к тому, что новички не научатся обращаться с шаблонами, а станут копировать тептар-код раскрытых шаблонов.
Временные шаблоны лучше не раскрывать, так как потом их будет труднее найти и удалить.
Избегайте использования подстановки шаблонов в примечаниях (теги <ref></ref>), или проверяйте её правильную работу. Ошибка в MediaWiki препятствует разворачиванию некоторых (если не всех) подстановок в примечаниях. См. en:Wikipedia:Footnotes#Known bugs (англ.).

Шаблоны, которые обязательно надо раскрыватьПравить

{{afd}} — к удалению
{{afi}} — к улучшению
{{АИ}} — запрос авторитетных источников с постановкой текущей даты

Шаблоны, которые следует использовать только с подстановкой, можно отмечать путём размещения шаблона {{только с подстановкой}} на их подстраницах документации.

Шаблоны, которые не следует раскрыватьПравить

Навигационные шаблоны (обычно создаются с помощью шаблоном {{Навигационная полоса}}, {{Навигационная таблица}} и т. д.)
Шаблоны-карточки (обычно создаются с помощью шаблона {{Карточка}})

Шаблоны, которые не следует использовать с подстановкой, можно отмечать путём размещения шаблона {{не подставлять}} на их подстраницах документации.