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

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


{{TOC right}}
== Использование ==
{{tc||''имя шаблона или страницы''|''флаги''|lang{{=}}''код языкового раздела''|sister{{=}}''код родственного проекта''|text{{=}}''текст ссылки''|comment{{=}}''всплывающая подсказка''}}
Все параметры являются необязательными.
Если использовать шаблон без параметров (или без первого параметра), то в фигурных скобках он выведет название текущей страницы (после двоеточия) со строчной первой буквы (это бывает полезно при упоминании шаблона в его собственной документации, особенно когда используется одна документация на несколько шаблонов).
Если использовать его с первым параметром, то он создаст ссылку на страницу, заданную в нём, за исключением случая, когда он уже находится на ней.
Флаги записываются через вертикальную черту, например <code>nl|s|u</code>, их может быть не больше четырёх. Список флагов:
* <code>nl</code> (<code>nolink</code>): подавить ссылку.
* <code>s</code> и <code>п</code>: вывести ключевое слово [[ВП:Подстановка шаблонов|<nowiki>«subst:» и «подст:»</nowiki>]] соответственно перед именем шаблона.
* <code>g</code> (от {{lang-en|global}}): ссылаться по умолчанию на основное [[Википедия:Пространства имён|пространство имён]] вместо пространства шаблонов. Этот флаг включается автоматически, если первым символом в названии шаблона или страницы является двоеточие, например '':Страница'' или ''<nowiki>:Участник:Некий участник/подстраница</nowiki>'' (вики-движок интерпретирует начальное двоеточие в названии страницы в фигурных скобках как ссылку на корневое пространство; так, {{tc|:Страница}} включит содержимое соответствующей страницы Википедии в текущую страницу).
* <code>nav</code>: при использовании шаблона в блоках навигации. Благодаря этому флагу, когда вы находитесь на той странице, на которую должна вести ссылка, название шаблона выделяется жирным. Например, так сделано в навигационном шаблоне {{t|Языковые шаблоны}}. Работает только при указанном первом параметре. Доступен шаблон-обёртка {{t|tnav}}.
* <code>noredir</code>: если ссылка ведёт на перенаправление, не перенаправлять (параметр URL ''?redirect=no''; используется, например, в {{t|днш}}).
* <code>u</code>: вывести имя шаблона с заглавной буквы. Работает только при опущенном первом параметре.
* <code>b</code> (от ''black''): не использовать серый цвет текста для фигурных скобок (чтобы названия шаблонов смотрелись опрятно в коде).
Список кодов родственных проектов, записываемых в параметре {{para|sister}}, см. на странице [[Википедия:Интервики]].
Для ссылок на шаблоны в английском разделе доступен шаблон-обёртка {{t|ent}}.
== Примеры ==
=== Базовые ===
Внешний вид этих примеров [наличие ссылки] будет отличаться на основной странице шаблона и на странице документации, [[Шаблон:T/doc]].
=== Флаги ===
=== Остальные параметры ===
=== Суперкомбо ===
Представим, что нам понадобилось сослаться на шаблон в китайском викисловаре, используемый с подстановкой, который некий участник хранит в своём личном пространстве, а текст ссылки заменить на свой:
== Детали ==
* Если шаблон используется без первого параметра, а в названии страницы есть слэш, то, что идёт после него, опускается.
* Шаблон понимает идентичность адресов ''<nowiki>Участник:Некий участник</nowiki>'' и ''<nowiki>Участник:Некий</nowiki>'''_'''участник'' и использует особые приёмы, чтобы обходить баги/особенности вики-движка, связанные с использованием символов «*», «:», «;» и т. п. на первом месте в названиях шаблонов или тексте ссылок. Не смутит его и замена символов их [[мнемоники в HTML|HTML-кодами]], типа &amp;#47; для «&#47;».
* Если вы хотите поменять что-то в этом шаблоне, воспользуйтесь тестами на странице [[Шаблон:T/тесты]] для проверки его работоспособности после внесения изменений.
== Можно сделать ==
* При ссылках на страницы в пространстве «Участник» и других (см. маску <code>Шаблон\:(Media|Служебная|Special|…</code> на [[MediaWiki:Titleblacklist]]) также можно автоматически включать флаг <code>g</code>, после чего нужда в ручном его указании останется только для других разделов.
* Шаблон сейчас не работает с опущенным первым параметром вне пространства «Шаблон» (но не факт, что за его пределами нужны документации).
== См. также ==
* [[:Шаблоны/Ссылки для внутреннего использования#Ссылки на шаблоны|Ссылки на шаблоны]]
*  — для таблиц с описаниями
*  — для категорий
{{шаблоны для документирования}}
<includeonly>
[[Категория:Шаблоны/модули, нуждающиеся в усовершенствовании]]
[[Категория:Шаблоны:Ссылки на шаблоны]]
[[Категория:Шаблоны:Для документирования шаблонов]]
</includeonly>
[[Категория:Шаблоны:Документация]]

Версия от 12:38, 6 июня 2023

Источник — https://wikixw.ru/index.php?title=Шаблон:Tl/doc&oldid=68857