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

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


Среди всего прочего, если в тексте ссылки всего один символ, в ссылку автоматически заключаются соседние фигурные скобки — {{t|!}}.
{{днш|t|ш|шаблон}}
 
{{днш|ш|шаблон}}


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


Если использовать его с первым параметром, то он создаст ссылку на страницу, заданную в нём (то есть поведёт себя, как шаблон {{t|tl}}), за исключением случая, когда он уже находится на ней.
Если использовать его с первым параметром, то он создаст ссылку на страницу, заданную в нём, за исключением случая, когда он уже находится на ней.


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


Список кодов родственных проектов, записываемых в параметре {{para|sister}}, см. на странице [[Тептар:Интервики]].
Список кодов родственных проектов, записываемых в параметре {{para|sister}}, см. на странице [[Тептар:ИнтерТептар]].


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


== Примеры ==
== Примеры ==
'''Базовые'''
=== Базовые ===
* {{tc|t}} → {{t}} &nbsp;(выводит название той страницы, на которой вы находитесь)
* {{tc|t}} → {{t}} &nbsp;(выводит название той страницы, на которой вы находитесь)
* {{tc||t}} → {{t|t}}
* {{tc||t}} → {{t|t}}
Строка 39: Строка 37:
* {{tc||:Страница}} → {{t|:Страница}}
* {{tc||:Страница}} → {{t|:Страница}}


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


{{^|1em}}
=== Флаги ===
'''Флаги'''
* {{tc||шаблон|nolink}} → {{t|шаблон|nolink}}
* {{tc||шаблон|nolink}} → {{t|шаблон|nolink}}
* {{tc||шаблон|п}} → {{t|шаблон|п}}
* {{tc||шаблон|п}} → {{t|шаблон|п}}
Строка 61: Строка 58:
* {{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}}


{{^|1em}}
=== Остальные параметры ===
'''Остальные параметры'''
* {{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}}


{{^|1em}}
=== Суперкомбо ===
'''Суперкомбо'''
Представим, что нам понадобилось сослаться на шаблон в китайском Тептар словаре, используемый с подстановкой, который некий участник хранит в своём личном пространстве, а текст ссылки заменить на свой:
 
Представим, что нам понадобилось сослаться на шаблон в китайском викисловаре, используемый с подстановкой, который некий участник хранит в своём личном пространстве, а текст ссылки заменить на свой:
* {{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名阴}}
<small>Он, кстати, реально существует.</small>


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


Строка 85: Строка 78:
== См. также ==
== См. также ==
* [[Тептар:Шаблоны/Ссылки для внутреннего использования#Ссылки на шаблоны|Ссылки на шаблоны]]
* [[Тептар:Шаблоны/Ссылки для внутреннего использования#Ссылки на шаблоны|Ссылки на шаблоны]]
* {{t|tp}} — почти то же самое с параметрами
* {{t|tc}} — символическая запись в тегах {{tagro|code}} и с параметрами (для создания примеров на страницах документации)
* {{t|tlc}} — то же, что предыдущий, плюс ссылка
* {{t|flt}} — короткий вариант для ссылок на шаблоны в других языковых разделах
* {{t|ent}} — для ссылок на шаблоны в английском разделе
* {{t|tagr}} — для тегов
* {{tl|mwmw}} — для «волшебных слов»
* {{tl|tRef}} — для таблиц с описаниями
* {{tl|tRef}} — для таблиц с описаниями
* {{tl|ub}} — для юзербоксов
* {{tl|cl}} — для категорий
* {{tl|cl}} — для категорий
{{шаблоны для документирования}}


<includeonly>
<includeonly>

Навигация