Шаблон:T/doc: различия между версиями
Andras (обсуждение | вклад) Нет описания правки |
Andras (обсуждение | вклад) мНет описания правки |
||
Строка 3: | Строка 3: | ||
{{OnLua|Template call code|withoutParams}} | {{OnLua|Template call code|withoutParams}} | ||
'''{{T||u}}''' — шаблон-комбайн для создания символической записи имён шаблонов или ссылок на них. С его помощью можно сослаться на шаблон (и не только) где угодно, с любым текстом ссылки или без неё. | '''{{T||u}}''' — шаблон-комбайн для создания символической записи имён шаблонов или ссылок на них. С его помощью можно сослаться на шаблон (и не только) где угодно, с любым текстом ссылки или без неё. | ||
{{TOC right}} | {{TOC right}} | ||
Строка 19: | Строка 17: | ||
Флаги записываются через вертикальную черту, например <code>nl|s|u</code>, их может быть не больше четырёх. Список флагов: | Флаги записываются через вертикальную черту, например <code>nl|s|u</code>, их может быть не больше четырёх. Список флагов: | ||
* <code>nl</code> (<code>nolink</code>): подавить ссылку. | * <code>nl</code> (<code>nolink</code>): подавить ссылку. | ||
* <code>s</code> и <code>п</code>: вывести ключевое слово [[ | * <code>s</code> и <code>п</code>: вывести ключевое слово [[РуСказки:Подстановка шаблонов|<nowiki>«subst:» и «подст:»</nowiki>]] соответственно перед именем шаблона. | ||
* <code>g</code> (от {{Lang-en|global}}): ссылаться по умолчанию на основное [[ | * <code>g</code> (от {{Lang-en|global}}): ссылаться по умолчанию на основное [[РуСказки:Пространства имён|пространство имён]] вместо пространства шаблонов. Этот флаг включается автоматически, если первым символом в названии шаблона или страницы является двоеточие, например '':Страница'' или ''<nowiki>:Участник:Некий участник/подстраница</nowiki>'' (вики-движок интерпретирует начальное двоеточие в названии страницы в фигурных скобках как ссылку на корневое пространство; так, {{Tc|:Страница}} включит содержимое соответствующей страницы РуСказок в текущую страницу). | ||
* <code>nav</code>: при использовании шаблона в блоках навигации. Благодаря этому флагу, когда вы находитесь на той странице, на которую должна вести ссылка, название шаблона выделяется жирным. Например, так сделано в навигационном шаблоне {{T|Языковые шаблоны}}. Работает только при указанном первом параметре. Доступен шаблон-обёртка {{T|Tnav}}. | * <code>nav</code>: при использовании шаблона в блоках навигации. Благодаря этому флагу, когда вы находитесь на той странице, на которую должна вести ссылка, название шаблона выделяется жирным. Например, так сделано в навигационном шаблоне {{T|Языковые шаблоны}}. Работает только при указанном первом параметре. Доступен шаблон-обёртка {{T|Tnav}}. | ||
* <code>noredir</code>: если ссылка ведёт на перенаправление, не перенаправлять (параметр URL ''?redirect=no''; используется, например, в {{T|Другие названия шаблона}}). | * <code>noredir</code>: если ссылка ведёт на перенаправление, не перенаправлять (параметр URL ''?redirect=no''; используется, например, в {{T|Другие названия шаблона}}). | ||
Строка 26: | Строка 24: | ||
* <code>b</code> (от ''black''): не использовать серый цвет текста для фигурных скобок (чтобы названия шаблонов смотрелись опрятно в коде). | * <code>b</code> (от ''black''): не использовать серый цвет текста для фигурных скобок (чтобы названия шаблонов смотрелись опрятно в коде). | ||
Список кодов родственных проектов, записываемых в параметре {{Para|sister}}, см. на странице [[ | Список кодов родственных проектов, записываемых в параметре {{Para|sister}}, см. на странице [[РуСказки:Интервики]]. | ||
Для ссылок на шаблоны в английском разделе доступен шаблон-обёртка {{T|Ent}}. | Для ссылок на шаблоны в английском разделе доступен шаблон-обёртка {{T|Ent}}. | ||
Строка 34: | Строка 32: | ||
* {{Tc|T}} → {{T}} (выводит название той страницы, на которой вы находитесь) | * {{Tc|T}} → {{T}} (выводит название той страницы, на которой вы находитесь) | ||
* {{Tc||T}} → {{T|T}} | * {{Tc||T}} → {{T|T}} | ||
* {{Tc||шаблон}} → {{T| | * {{Tc||шаблон}} → {{T|Шаблон}} | ||
* {{Tc||:Страница}} → {{T|:Страница}} | * {{Tc||:Страница}} → {{T|:Страница}} | ||
Строка 41: | Строка 39: | ||
=== Флаги === | === Флаги === | ||
* {{Tc||шаблон|nolink}} → {{T|шаблон|nolink}} | * {{Tc||шаблон|nolink}} → {{T|шаблон|nolink}} | ||
* {{Tc||шаблон|п}} → {{T| | * {{Tc||шаблон|п}} → {{T|Шаблон|п}} | ||
* {{Tc||Участник:Jack who built the house/t|g}} → {{T|Участник:Jack who built the house/t|g}} | * {{Tc||Участник:Jack who built the house/t|g}} → {{T|Участник:Jack who built the house/t|g}} | ||
* {{Tc||шаблон|noredir}} → {{T|шаблон|noredir}} | * {{Tc||шаблон|noredir}} → {{T|шаблон|noredir}} | ||
Строка 78: | Строка 76: | ||
== См. также == | == См. также == | ||
* [[Википедия:Шаблоны/Ссылки для внутреннего использования#Ссылки на шаблоны|Ссылки на шаблоны]] | * [[Википедия:Шаблоны/Ссылки для внутреннего использования#Ссылки на шаблоны|Ссылки на шаблоны]] | ||
* {{ | * {{T|TRef}} — для таблиц с описаниями | ||
* {{ | * {{T|Cl}} — для категорий | ||
{{Шаблоны для документирования}} | {{Шаблоны для документирования}} |
Текущая версия от 12:46, 26 июня 2023
![]() |
![]() | Прежде чем вносить какие-либо изменения в данный шаблон, просьба оттестировать их в /песочнице и проверить результат на странице с /контрольными примерами. Изменения могут быть внесены после этого в данный шаблон всего одной правкой. |
![]() | Этот шаблон реализован на основе Lua с использованием функции withoutParams() из модуля Template call code. |
{{T}} — шаблон-комбайн для создания символической записи имён шаблонов или ссылок на них. С его помощью можно сослаться на шаблон (и не только) где угодно, с любым текстом ссылки или без неё.
Использование
{{T|имя шаблона или страницы|флаги|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}}
→ {{t}} (выводит название той страницы, на которой вы находитесь){{T|T}}
→ {{T}}{{T|шаблон}}
→ {{Шаблон}}{{T|:Страница}}
→ {{:Страница}}
Внешний вид этих примеров [наличие ссылки] будет отличаться на основной странице шаблона и на странице документации, Шаблон:T/doc.
Флаги
{{T|шаблон|nolink}}
→ {{шаблон}}{{T|шаблон|п}}
→ {{подст:Шаблон}}{{T|Участник:Jack who built the house/t|g}}
→ {{Участник:Jack who built the house/t}}{{T|шаблон|noredir}}
→ {{шаблон}}{{T||u}}
→ {{T}}{{T|шаблон|b}}
→ {{шаблон}}
Флаг nav
/ шаблон {{Tnav}}:
{{Tnav|T}}{{•}}{{Tnav|Tlp}}{{•}}{{Tnav|Tc}}{{•}}{{Tnav|Tcl}}
{{T}}Шаблон:•{{Tlp}}Шаблон:•{{Tc}}Шаблон:•{{Tcl}}
Сразу несколько:
{{T||nl|s|u|b}}
→ {{subst:T}}{{T|Участник:Jack who built the house/t|п|g|b}}
→ {{подст:Участник:Jack who built the house/t}}
Остальные параметры
{{T|lang|text=lang-''xx''}}
→ {{lang-xx}}{{T|Удалялось|comment=Статья удалялась, но была восстановлена или была оставлена страница обсуждения удалённой статьи}}
→ {{Удалялось}}{{T|template|lang=en|sister=q}}
→ {{template}}
Суперкомбо
Представим, что нам понадобилось сослаться на шаблон в китайском викисловаре, используемый с подстановкой, который некий участник хранит в своём личном пространстве, а текст ссылки заменить на свой:
{{T|User:Shizhao/Template:ru-sy名阴|g|s|lang=zh|sister=wikt|text=ru-sy名阴}}
→ {{subst:ru-sy名阴}}
Детали
- Если шаблон используется без первого параметра, а в названии страницы есть слэш, то, что идёт после него, опускается.
- Шаблон понимает идентичность адресов Участник:Некий участник и Участник:Некий_участник и использует особые приёмы, чтобы обходить баги/особенности вики-движка, связанные с использованием символов «*», «:», «;» и т. п. на первом месте в названиях шаблонов или тексте ссылок. Не смутит его и замена символов их HTML-кодами, типа / для «/».
- Если вы хотите поменять что-то в этом шаблоне, воспользуйтесь тестами на странице Шаблон:T/тесты для проверки его работоспособности после внесения изменений.
Можно сделать
- При ссылках на страницы в пространстве «Участник» и других (см. маску
Шаблон\:(Media|Служебная|Special|…
на MediaWiki:Titleblacklist) также можно автоматически включать флагg
, после чего нужда в ручном его указании останется только для других разделов. - Шаблон сейчас не работает с опущенным первым параметром вне пространства «Шаблон» (но не факт, что за его пределами нужны документации).
См. также
- Ссылки на шаблоны
- {{TRef}} — для таблиц с описаниями
- {{Cl}} — для категорий