Шаблон:Tl/doc

{{tl}} — шаблон-комбайн для создания символической записи имён шаблонов или ссылок на них. С его помощью можно сослаться на шаблон (и не только) где угодно, с любым текстом ссылки или без неё.

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

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

{{tl|имя шаблона или страницы|флаги|lang=код языкового раздела|sister=код родственного проекта|text=текст ссылки|comment=всплывающая подсказка}}

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

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

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

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

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

Список кодов родственных проектов, записываемых в параметре |sister =, см. на странице Википедия:Интервики.

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

Примеры

Базовые

• {{t}} → {{tl}}  (выводит название той страницы, на которой вы находитесь)
• {{tl|t}} → {{t}}
• {{tl|шаблон}} → {{шаблон}}
• {{tl|:Страница}} → {{:Страница}}

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

Флаги

• {{tl|шаблон|nolink}} → {{шаблон}}
• {{tl|шаблон|п}} → {{подст:шаблон}}
• {{tl|Участник:Jack who built the house/t|g}} → {{Участник:Jack who built the house/t}}
• {{tl|шаблон|noredir}} → {{шаблон}}
• {{tl||u}} → {{Tl}}
• {{tl|шаблон|b}} → {{шаблон}}

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

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

↓

{{t}} · {{tp}} · {{tc}} · {{tlc}}

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

• {{tl||nl|s|u|b}} → {{subst:Tl}}
• {{tl|Участник:Jack who built the house/t|п|g|b}} → {{подст:Участник:Jack who built the house/t}}

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

• {{tl|lang|text=lang-''xx''}} → {{lang-xx}}
• {{tl|Удалялось|comment=Статья удалялась, но была восстановлена или была оставлена страница обсуждения удалённой статьи}} → {{Удалялось}}
• {{tl|template|lang=en|sister=q}} → {{template}}

Суперкомбо

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

• {{tl|User:Shizhao/Template:ru-sy名阴|g|s|lang=zh|sister=wikt|text=ru-sy名阴}} → {{subst:ru-sy名阴}}

Детали

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

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

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

TemplateData

Внутристрочный шаблон для оформления ссылок на страницы шаблонов.

Параметры шаблона

Шаблон использует строчное форматирование параметров.

Параметр		Описание	Тип	Статус
Название шаблона	1	без описания	Имя шаблона	обязательный
Флаги	2	без описания Предлагаемые значения nolink s g nav noredir u b	Неизвестно	необязательный
lang	lang	без описания	Неизвестно	необязательный
sister	sister	без описания	Неизвестно	необязательный
text	text	без описания	Неизвестно	необязательный
comment	comment	без описания	Неизвестно	необязательный

См. также

• Ссылки на шаблоны
• {{tRef}} — для таблиц с описаниями
• {{cl}} — для категорий