Шаблон:Tl/doc

{{#invoke:Message box|fmbox}} {{#invoke:Message box|ombox}} {{#invoke:Message box|ombox}} {{[[Шаблон:{{{1}}}|{{{1}}}]]}} — шаблон-комбайн для создания символической записи имён шаблонов или ссылок на них. С его помощью можно сослаться на шаблон (и не только) где угодно, с любым текстом ссылки или без неё.

Другие названия этого шаблона: {{t|<noredir>}}, {{ш|<noredir>}}, {{шаблон|<noredir>}}.

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

{{safesubst:#invoke: Template call code | withParams | _tag = code }}

Все параметры являются необязательными.

Если использовать шаблон без параметров (или без первого параметра), то в фигурных скобках он выведет название текущей страницы (после двоеточия) со строчной первой буквы (это бывает полезно при упоминании шаблона в его собственной документации, особенно когда используется одна документация на несколько шаблонов).

Если использовать его с первым параметром, то он создаст ссылку на страницу, заданную в нём, за исключением случая, когда он уже находится на ней.

Флаги записываются через вертикальную черту, например nl|s|u, их может быть не больше четырёх. Список флагов:

• nl (nolink): подавить ссылку.
• s и п: вывести ключевое слово «subst:» и «подст:» соответственно перед именем шаблона.
• g (от Шаблон:Lang-en): ссылаться по умолчанию на основное пространство имён вместо пространства шаблонов. Этот флаг включается автоматически, если первым символом в названии шаблона или страницы является двоеточие, например :Страница или :Участник:Некий участник/подстраница (вики-движок интерпретирует начальное двоеточие в названии страницы в фигурных скобках как ссылку на корневое пространство; так, {{safesubst:#invoke: Template call code | withParams | _tag = code }} включит содержимое соответствующей страницы Википедии в текущую страницу).
• nav: при использовании шаблона в блоках навигации. Благодаря этому флагу, когда вы находитесь на той странице, на которую должна вести ссылка, название шаблона выделяется жирным. Например, так сделано в навигационном шаблоне {{Языковые шаблоны}}. Работает только при указанном первом параметре. Доступен шаблон-обёртка {{tnav}}.
• noredir: если ссылка ведёт на перенаправление, не перенаправлять (параметр URL ?redirect=no; используется, например, в {{днш}}).
• u: вывести имя шаблона с заглавной буквы. Работает только при опущенном первом параметре.
• b (от black): не использовать серый цвет текста для фигурных скобок (чтобы названия шаблонов смотрелись опрятно в коде).

Список кодов родственных проектов, записываемых в параметре Шаблон:Para, см. на странице Википедия:Интервики.

Для ссылок на шаблоны в английском разделе доступен шаблон-обёртка {{ent}}.

Примеры

Базовые

• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{[[Шаблон:{{{1}}}|{{{1}}}]]}}  (выводит название той страницы, на которой вы находитесь)
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{t}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{шаблон}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{[[Шаблон::Страница|:Страница]]}}

Внешний вид этих примеров [наличие ссылки] будет отличаться на основной странице шаблона и на странице документации, Шаблон:T/doc.

Флаги

• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{шаблон|<nolink>}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{шаблон|<п>}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{Участник:Jack who built the house/t|<g>}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{шаблон|<noredir>}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{[[Шаблон:|]]|<u>}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{шаблон|<b>}}

Шаблон:^ Флаг nav / шаблон {{tnav}}:

{{tnav|t}}{{·}}{{tnav|tp}}{{·}}{{tnav|tc}}{{·}}{{tnav|tlc}}

Шаблон:Sp↓ Шаблон:Tnav • Шаблон:Tnav • Шаблон:Tnav • Шаблон:Tnav

Шаблон:^ Сразу несколько:

• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{[[Шаблон:|]]|<nl>|<s>|<u>|<b>}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{Участник:Jack who built the house/t|<п>|<g>|<b>}}

Остальные параметры

• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{lang}}
• {{#invoke:Example|main}}
• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{template}}

Суперкомбо

Представим, что нам понадобилось сослаться на шаблон в китайском викисловаре, используемый с подстановкой, который некий участник хранит в своём личном пространстве, а текст ссылки заменить на свой:

• {{safesubst:#invoke: Template call code | withParams | _tag = code }} → {{User:Shizhao/Template:ru-sy名阴|<g>|<s>}}

Детали

• Если шаблон используется без первого параметра, а в названии страницы есть слэш, то, что идёт после него, опускается.
• Шаблон понимает идентичность адресов Участник:Некий участник и Участник:Некий_участник и использует особые приёмы, чтобы обходить баги/особенности вики-движка, связанные с использованием символов «*», «:», «;» и т. п. на первом месте в названиях шаблонов или тексте ссылок. Не смутит его и замена символов их HTML-кодами, типа &#47; для «/».
• Если вы хотите поменять что-то в этом шаблоне, воспользуйтесь тестами на странице Шаблон:T/тесты для проверки его работоспособности после внесения изменений.

Можно сделать

• При ссылках на страницы в пространстве «Участник» и других (см. маску Шаблон\:(Media|Служебная|Special|… на MediaWiki:Titleblacklist) также можно автоматически включать флаг g, после чего нужда в ручном его указании останется только для других разделов.
• Шаблон сейчас не работает с опущенным первым параметром вне пространства «Шаблон» (но не факт, что за его пределами нужны документации).

См. также

• Ссылки на шаблоны
• {{safesubst:#invoke: Template call code | withoutParams }} — для таблиц с описаниями
• {{safesubst:#invoke: Template call code | withoutParams }} — для категорий