Редактирование: Шаблон:Tlp/doc

{{Docpage}}
{{OnLua|Template call code|withParams}}__NOTOC__
'''{{Tl|Tlp}}''' — шаблон для оформления ссылок на шаблоны с указанием параметров.

== Использование ==
{{Tc|Tlp|''имя шаблона''|''параметры''{{Optp|''настройки''|_lang{{=}}''код языкового раздела''|_sister{{=}}''код родственного проекта''|_text{{=}}''текст ссылки''}}}}

Все параметры являются необязательными. Чёрным цветом даны базовые параметры, серым — дополнительные{{Sp/}}редко используемые.

{{Tc/=}}

В параметрах шаблона нельзя вписывать конструкции с фигурными скобками. Их можно заключать в {{Tag|Nowiki}}; см. [[#Примеры|Примеры]].

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

''Настройки'' записываются как булевы значения («истина»{{Sp/}}«ложь») параметров-переключателей, например <code>_u=1</code> — «истина» (подойдёт любое непустое значение). Параметры-переключатели включают в себя:
* <code>_nl</code> (<code>_nolink</code>)''':''' подавить ссылку.
* <code>_s</code> и <code>_п</code>''':''' вывести ключевое слово [[ВП:Подстановка шаблонов|<nowiki>«subst:» и «подст:»</nowiki>]] соответственно перед именем шаблона (можно просто дописать <nowiki>«subst:» или «подст:»</nowiki> в название шаблона).
* <code>_u</code>''':''' вывести имя шаблона с заглавной буквы. Работает только при опущенном первом параметре.
* <code>_b</code> (от ''black'')''':''' не использовать оформление (серый цвет текста; чтобы названия шаблонов смотрелись опрятно в коде).
* <code>_nav</code>''':''' при использовании шаблона в рамках блока навигации. Благодаря этой настройке, когда вы находитесь на той странице, на которую должна вести ссылка, название шаблона выделяется курсивом, что удобно для восприятия блоков навигации. Например, так сделано в навигационном шаблоне {{Tl|Языковые шаблоны}} для шаблонов {{Tl|Tl}}. Работает только при указанном первом параметре.
* <code>_nobr</code>''':''' запретить перенос на следующую строку в середине кода.

== Примеры ==
'''Базовые'''
* {{Пример||Шаблон|параметр|_u=1}}
* {{Пример||Шаблон|параметр=значение|_u=1}}
* {{Пример||Шаблон|параметр 1|||параметр 4|_u=1}}
* {{Пример||Шаблон|&lt;nowiki><nowiki>{{IPA|/tʃ/}}</nowiki>&lt;/nowiki>|_u=1}}
* {{Пример|||параметр|_u=1}} &nbsp;(в качестве названия шаблона выводит название той страницы, на которой вы находитесь)

{{^}}
'''Настройки'''
* {{Пример||Шаблон|параметр|_nolink{{=}}1|_u=1}}
* {{Пример||Шаблон|параметр|_п{{=}}1|_u=1}}
* {{Пример|||параметр|_u{{=}}1|_u=1}}
* {{Пример||Шаблон|параметр|_b{{=}}1|_u=1}}

{{^}}
Параметр {{Cn|_Nav}}''':'''
* {{Пример|Tlp|Tl|''шаблон''|_nav{{=}}1}}
* {{Пример|Tlp|Tlp|''шаблон''|''параметры''|_nav{{=}}1}}
* {{Пример|Tlp|Tc|''шаблон''|''параметры''|_nav{{=}}1}}
* {{Пример|Tlp|Tcl|''шаблон''|''параметры''|_nav{{=}}1}}
{{^}}
'''Остальные параметры'''
* {{Пример||Lang|''слово на иностранном языке''|_text{{=}}Lang-''xx''|_u=1}}
* {{Пример||Template|parameter|_lang{{=}}en|_sister{{=}}q|_u=1}}

== Детали ==
* Если шаблон используется без первого параметра, а в названии страницы есть слэш, то, что идёт после него, опускается.
* Шаблон понимает идентичность адресов ''Участник:Некий участник'' и ''Участник:Некий'''_'''участник'' и использует особые приёмы, чтобы обходить баги/особенности вики-движка, связанные с использованием символов «*», «:», «;» и т. п. на первом месте в названиях шаблонов или тексте ссылок. Не смутит его и замена символов их [[мнемоники в HTML|HTML-кодами]], типа {{Amp|#47}} для «&#47;».
* Код шаблона устроен подобно коду {{Tl|Tl}}.

{{Шаблоны для документирования}}

<includeonly>
[[Категория:Шаблоны:Для шаблонов]]
[[Категория:Шаблоны:Ссылки на шаблоны]]
</includeonly>