Шаблон:Tlp/doc: различия между версиями
Mansur700 (обсуждение | вклад) (Новая страница: «{{docpage}} {{onLua|Template call code|withParams}}__NOTOC__ '''{{t}}''' — шаблон для оформления ссылок на шаблоны с указ...») |
(нет различий)
|
Версия от 08:17, 18 июня 2020
Этот шаблон реализован на основе Lua с использованием функции withParams() из модуля Template call code. |
{{tlp}} — шаблон для оформления ссылок на шаблоны с указанием параметров.
Использование
{{tlp|имя шаблона|параметры|настройки|_lang=код языкового раздела|_sister=код родственного проекта|_text=текст ссылки}}
Все параметры являются необязательными. Чёрным цветом даны базовые параметры, серым — дополнительные / редко используемые.
Важно: хотя шаблон и способен отобразить параметры, которые переданы в него как именованные, то есть такие, где название параметра и значение разделены знаком «=» (благодаря использованию модуля ParamValue2Value), такие параметры в настоящий момент переносятся в конец списка, а их порядок искажается. Чтобы этого избежать, заменяйте знак «=» на {{=}}
или забирайте параметры в <nowiki></nowiki>
. Также это следует проделывать для параметров, имена которых начинаются со знака подчеркивания, иначе они не отобразятся.
В параметрах шаблона нельзя вписывать конструкции с фигурными скобками. Их можно заключать в <nowiki></nowiki>
; см. Примеры.
Если использовать шаблон без первого параметра, то в качестве названия шаблона он выведет название текущей страницы (после двоеточия) со строчной первой буквы (это бывает полезно при упоминании шаблона в его собственной документации, особенно когда используется одна документация на несколько шаблонов).
Настройки записываются как булевы значения («истина» / «ложь») параметров-переключателей, например _u=1
— «истина» (подойдёт любое непустое значение). Параметры-переключатели включают в себя:
_nl
(_nolink
): подавить ссылку._s
и_п
: вывести ключевое слово «subst:» и «подст:» соответственно перед именем шаблона (можно просто дописать «subst:» или «подст:» в название шаблона)._u
: вывести имя шаблона с заглавной буквы. Работает только при опущенном первом параметре._b
(от black): не использовать оформление (серый цвет текста; чтобы названия шаблонов смотрелись опрятно в коде)._nav
: при использовании шаблона в рамках блока навигации. Благодаря этой настроке, когда вы находитесь на той странице, на которую должна вести ссылка, название шаблона выделяется жирным, что удобно для восприятия блоков навигации. Например, так сделано в навигационном шаблоне {{Языковые шаблоны}} для шаблонов {{t}}. Работает только при указанном первом параметре._nobr
: запретить перенос на следующую строку в середине кода.
Список кодов родственных проектов, записываемых в параметре _sister
, см. на странице Тептар:Интервики.
Примеры
Базовые
{{tlp|шаблон|параметр}}
→ {{шаблон|параметр}}{{tlp|шаблон|параметр=значение}}
→ {{шаблон|параметр=значение}}{{tlp|шаблон|параметр 1|||параметр 4}}
→ {{шаблон|параметр 1|||параметр 4}}{{tlp|шаблон|<nowiki>{{IPA|/tʃ/}}</nowiki>}}
→ {{шаблон|{{IPA|/tʃ/}}}}{{tlp||параметр}}
→ {{tlp|параметр}} (в качестве названия шаблона выводит название той страницы, на которой вы находитесь)
Настройки
{{tlp|шаблон|параметр|_nolink=1}}
→ {{шаблон|параметр}}{{tlp|шаблон|параметр|_п=1}}
→ {{подст:шаблон|параметр}}{{tlp||параметр|_u=1}}
→ {{Tlp|параметр}}{{tlp|шаблон|параметр|_b=1}}
→ {{шаблон|параметр}}
Параметр nav
:
{{tlp|t|''шаблон''|_nav=1}}{{·}}{{tlp|tlp|''шаблон''|''параметры''|_nav=1}}{{·}}{{tlp|tc|''шаблон''|''параметры''|_nav=1}}{{·}}{{tlp|tlc|''шаблон''|''параметры''|_nav=1}}
{{t|шаблон}} · {{tlp|шаблон|параметры}} · {{tc|шаблон|параметры}} · {{tlc|шаблон|параметры}}
Остальные параметры
{{tlp|lang|''слово на иностранном языке''|_text=lang-''xx''}}
→ {{lang-xx|слово на иностранном языке}}{{tlp|template|parameter|_lang=en|_sister=q}}
→ {{template|parameter}}
Детали
- Если шаблон используется без первого параметра, а в названии страницы есть слэш, то, что идёт после него, опускается.
- Шаблон понимает идентичность адресов Участник:Некий участник и Участник:Некий_участник и использует особые приёмы, чтобы обходить баги/особенности вики-движка, связанные с использованием символов «*», «:», «;» и т. п. на первом месте в названиях шаблонов или тексте ссылок. Не смутит его и замена символов их HTML-кодами, типа
/
для «/». - Код шаблона устроен подобно коду {{t}}.
См. также
- {{tc}} — то же самое в тегах
<code>
, но без ссылки (для создания примеров на страницах документации) - {{tlc}} — то же самое в тегах
<code>
- {{t}} — без параметров, но с некоторыми дополнительными возможностями
- {{tls}} / {{шсп}} — с «subst:» / «подст:» (также можно использовать {{tlp|subst:template|параметры}} и {{tlp|подст:шаблон|параметры}})