Шаблон:Tl/doc: различия между версиями

Материал из Народные сказки
Перейти к навигации Перейти к поиску
Нет описания правки
Нет описания правки
Строка 4: Строка 4:
'''{{t}}''' — шаблон-комбайн для создания символической записи имён шаблонов или ссылок на них. С его помощью можно сослаться на шаблон (и не только) где угодно, с любым текстом ссылки или без неё.
'''{{t}}''' — шаблон-комбайн для создания символической записи имён шаблонов или ссылок на них. С его помощью можно сослаться на шаблон (и не только) где угодно, с любым текстом ссылки или без неё.


{{днш|t|ш|шаблон}}
{{днш|T|ш|шаблон}}


{{TOC right}}
{{TOC right}}
Строка 20: Строка 20:
* <code>nl</code> (<code>nolink</code>): подавить ссылку.
* <code>nl</code> (<code>nolink</code>): подавить ссылку.
* <code>s</code> и <code>п</code>: вывести ключевое слово [[ВП:Подстановка шаблонов|<nowiki>«subst:» и «подст:»</nowiki>]] соответственно перед именем шаблона.
* <code>s</code> и <code>п</code>: вывести ключевое слово [[ВП:Подстановка шаблонов|<nowiki>«subst:» и «подст:»</nowiki>]] соответственно перед именем шаблона.
* <code>g</code> (от {{lang-en|global}}): ссылаться по умолчанию на основное [[Википедия:Пространства имён|пространство имён]] вместо пространства шаблонов. Этот флаг включается автоматически, если первым символом в названии шаблона или страницы является двоеточие, например '':Страница'' или ''<nowiki>:Участник:Некий участник/подстраница</nowiki>'' (вики-движок интерпретирует начальное двоеточие в названии страницы в фигурных скобках как ссылку на корневое пространство; так, {{Tc|:Страница}} включит содержимое соответствующей страницы Википедии в текущую страницу).
* <code>g</code> (от {{Tang-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|днш}}).
* <code>u</code>: вывести имя шаблона с заглавной буквы. Работает только при опущенном первом параметре.
* <code>u</code>: вывести имя шаблона с заглавной буквы. Работает только при опущенном первом параметре.
* <code>b</code> (от ''black''): не использовать серый цвет текста для фигурных скобок (чтобы названия шаблонов смотрелись опрятно в коде).
* <code>b</code> (от ''black''): не использовать серый цвет текста для фигурных скобок (чтобы названия шаблонов смотрелись опрятно в коде).
Строка 28: Строка 28:
Список кодов родственных проектов, записываемых в параметре {{Para|sister}}, см. на странице [[Википедия:Интервики]].
Список кодов родственных проектов, записываемых в параметре {{Para|sister}}, см. на странице [[Википедия:Интервики]].


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


== Примеры ==
== Примеры ==
=== Базовые ===
=== Базовые ===
* {{Tc|t}} → {{t}} &nbsp;(выводит название той страницы, на которой вы находитесь)
* {{Tc|T}} → {{T}} &nbsp;(выводит название той страницы, на которой вы находитесь)
* {{Tc||t}} → {{t|t}}
* {{Tc||T}} → {{T|T}}
* {{Tc||шаблон}} → {{t|шаблон}}
* {{Tc||шаблон}} → {{T|шаблон}}
* {{Tc||:Страница}} → {{t|:Страница}}
* {{Tc||:Страница}} → {{T|:Страница}}


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


=== Флаги ===
=== Флаги ===
* {{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}}
* {{Tc|||u}} → {{t||u}}
* {{Tc|||u}} → {{T||u}}
* {{Tc||шаблон|b}} → {{t|шаблон|b}}
* {{Tc||шаблон|b}} → {{T|шаблон|b}}


{{^|1em}}
{{^|1em}}
Флаг <code>nav</code> / шаблон {{t|tnav}}:
Флаг <code>nav</code> / шаблон {{T|tnav}}:
<pre>{{tnav|t}}{{*}}{{tnav|tp}}{{*}}{{tnav|Tc}}{{*}}{{tnav|tlc}}</pre>
<pre>{{Tnav|T}}{{*}}{{Tnav|Tp}}{{*}}{{Tnav|Tc}}{{*}}{{Tnav|Tlc}}</pre>
{{sp↓}}
{{Sp↓}}
{{tnav|t}}{{*}}{{tnav|tp}}{{*}}{{tnav|Tc}}{{*}}{{tnav|tlc}}
{{Tnav|T}}{{*}}{{Tnav|Tp}}{{*}}{{Tnav|Tc}}{{*}}{{Tnav|Tlc}}


{{^|1em}}
{{^|1em}}
Сразу несколько:
Сразу несколько:
* {{Tc|||nl|s|u|b}} → {{t||nl|s|u|b}}
* {{Tc|||nl|s|u|b}} → {{T||nl|s|u|b}}
* {{Tc||Участник:Jack who built the house/t|п|g|b}} → {{t|Участник:Jack who built the house/t|п|g|b}}
* {{Tc||Участник:Jack who built the house/t|п|g|b}} → {{T|Участник:Jack who built the house/t|п|g|b}}


=== Остальные параметры ===
=== Остальные параметры ===
* {{Tc||lang|<nowiki>text=lang-''xx''</nowiki>}} → {{t|lang|text=lang-''xx''}}
* {{Tc||lang|<nowiki>text=lang-''xx''</nowiki>}} → {{T|lang|text=lang-''xx''}}
* {{Пример||Удалялось|comment{{=}}Статья удалялась, но была восстановлена или была оставлена страница обсуждения удалённой статьи}}
* {{Пример||Удалялось|comment{{=}}Статья удалялась, но была восстановлена или была оставлена страница обсуждения удалённой статьи}}
* {{Tc||template|<nowiki>lang=en|sister=q</nowiki>}} → {{t|template|lang=en|sister=q}}
* {{Tc||template|<nowiki>lang=en|sister=q</nowiki>}} → {{T|template|lang=en|sister=q}}


=== Суперкомбо ===
=== Суперкомбо ===
Представим, что нам понадобилось сослаться на шаблон в китайском викисловаре, используемый с подстановкой, который некий участник хранит в своём личном пространстве, а текст ссылки заменить на свой:
Представим, что нам понадобилось сослаться на шаблон в китайском викисловаре, используемый с подстановкой, который некий участник хранит в своём личном пространстве, а текст ссылки заменить на свой:
* {{Tc||User:Shizhao/Template:ru-sy名阴|g|s|<nowiki>lang=zh|sister=wikt|text=ru-sy名阴</nowiki>}} → {{t|User:Shizhao/Template:ru-sy名阴|g|s|lang=zh|sister=wikt|text=ru-sy名阴}}
* {{Tc||User:Shizhao/Template:ru-sy名阴|g|s|<nowiki>lang=zh|sister=wikt|text=ru-sy名阴</nowiki>}} → {{T|User:Shizhao/Template:ru-sy名阴|g|s|lang=zh|sister=wikt|text=ru-sy名阴}}


== Детали ==
== Детали ==
Строка 79: Строка 79:
* [[Википедия:Шаблоны/Ссылки для внутреннего использования#Ссылки на шаблоны|Ссылки на шаблоны]]
* [[Википедия:Шаблоны/Ссылки для внутреннего использования#Ссылки на шаблоны|Ссылки на шаблоны]]
* {{Tl|tRef}} — для таблиц с описаниями
* {{Tl|tRef}} — для таблиц с описаниями
* {{Tl|cl}} — для категорий
* {{Tl|Cl}} — для категорий


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

Версия от 17:44, 9 мая 2023

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

Шаблон:днш

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

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

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

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

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

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

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

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

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

Примеры

Базовые

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

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

Флаги

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

{{Tnav|T}}{{*}}{{Tnav|Tp}}{{*}}{{Tnav|Tc}}{{*}}{{Tnav|Tlc}}

Шаблон:Sp↓ {{T}}Шаблон:*{{Tp}}Шаблон:*{{Tc}}Шаблон:*{{Tlc}}

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

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

  • {{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-кодами, типа &#47; для «/».
  • Если вы хотите поменять что-то в этом шаблоне, воспользуйтесь тестами на странице Шаблон:T/тесты для проверки его работоспособности после внесения изменений.

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

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

См. также