|
|
| Строка 1: |
Строка 1: |
| − | <noinclude>{{docpage}}</noinclude>Этот шаблон является расширенной версией {{tl|comment}}. | + | <includeonly>{{#switch: {{{3|1}}} |
| − | | + | | 0 = <abbr title="{{#tag:nowiki|{{{2}}}}}">{{{1}}}</abbr> |
| − | Всплывающая подсказка расшифровывает значение аббревиатуры и ссылается на соответствующую статью, например: {{abbr|РФ|Российская Федерация|Россия}}.
| + | | 1 = [[{{{1}}}|<abbr title="{{#tag:nowiki|{{{2}}}}}">{{{1}}}</abbr>]] |
| − | | + | | 2 = <abbr title="{{#tag:nowiki|{{{2}}}}}">[[{{{2}}}|{{{1}}}]]</abbr> |
| − | Можно использовать перенаправления {{tl|Аббревиатура}} и {{tl|Аббр}}.
| + | | #default = [[{{{3}}}|<abbr title="{{#tag:nowiki|{{{2}}}}}">{{{1}}}</abbr>]] |
| − | | + | }}</includeonly><noinclude> |
| − | == Синтаксис ==
| + | {{doc}} |
| − | <nowiki>{{</nowiki>abbr|аббревиатура|расшифровка|ссылка<nowiki>}}</nowiki>
| + | [[Категория:Шаблоны:Форматирование|Abbr]] |
| − | Необязательный третий параметр указывает, какой из параметров использовать в качестве ссылки на статью
| + | </noinclude> |
| − | * 0 — подавляет ссылку
| + | |
| − | * 1 — ссылается на параметр «аббревиатура» (по умолчанию)
| + | |
| − | * 2 — ссылается на параметр «расшифровка»
| + | |
| − | * другое — ссылается на параметр «ссылка»
| + | |
| − | | + | |
| − | == Примеры == | + | |
| − | | + | |
| − | 1. Ссылка по умолчанию или явно указана на параметр «аббревиатура» | + | |
| − | <nowiki>{{</nowiki>abbr|АН СССР|Академия наук СССР<nowiki>}}</nowiki>
| + | |
| − | или
| + | |
| − | <nowiki>{{</nowiki>abbr|АН СССР|Академия наук СССР|1<nowiki>}}</nowiki>
| + | |
| − | | + | |
| − | Результат: {{abbr|АН СССР|Академия наук СССР}}
| + | |
| − | | + | |
| − | | + | |
| − | 2. Ссылка подавлена | + | |
| − | <nowiki>{{</nowiki>abbr|ПТЗ|Павлодарский тракторный завод|0<nowiki>}}</nowiki>
| + | |
| − |
| + | |
| − | Результат: {{abbr|ПТЗ|Павлодарский тракторный завод|0}}
| + | |
| − | | + | |
| − | | + | |
| − | 3. Ссылка явно указана на параметр «расшифровка»
| + | |
| − | <nowiki>{{</nowiki>abbr|ПАВ|Поверхностно-активные вещества|2<nowiki>}}</nowiki>
| + | |
| − |
| + | |
| − | Результат: {{abbr|ПАВ|Поверхностно-активные вещества|2}}
| + | |
| − | | + | |
| − | | + | |
| − | 4. Ссылка задана на произвольную страницу. В данном случае ссылка ошибочно ссылается на статью «[[Психоактивные вещества]]» хотя в расшифровано как «[[Поверхностно-активные вещества]]». Это сделано намеренно для демонстрации возможностей шаблона.
| + | |
| − | <nowiki>{{</nowiki>abbr|ПАВ|Поверхностно-активные вещества|Психоактивные вещества<nowiki>}}</nowiki>
| + | |
| − | | + | |
| − | Результат: {{abbr|ПАВ|Поверхностно-активные вещества|Психоактивные вещества}}
| + | |
| − | | + | |
| − | == Технические ограничения == | + | |
| − | Технические ограничения те же, что и в шаблоне {{tl|comment}}.
| + | |
| − | | + | |
| − | * В тексте подсказки не должно быть знака машинописных кавычек <code style="border:1px dotted gray; padding:1px">"</code> (типографские кавычки <code style="border:1px dotted gray; padding:1px">«»</code> допустимы).
| + | |
| − | * Если в параметрах шаблона есть знак <code style="border:1px dotted gray; padding:1px">=</code>, то, как и в любом другом шаблоне, приходится использовать явные номера параметров: <tt style="white-space:nowrap"><nowiki>{{comment|1=текст|2=подсказка}}</nowiki></tt>.
| + | |
| − | * В некоторых браузерах длина всплывающей подсказки ограничена. Например, в браузере Mozilla Firefox до третьей версии подсказки были однострочными.
| + | |
| − | * Пользователи [[смартфон]]ов и [[Планшетный компьютер|планшетных компьютеров]], как правило, не имеют возможности увидеть всплывающую подсказку, поэтому используйте данный шаблон только там, где это действительно необходимо.
| + | |
| − | | + | |
| − | <includeonly> | + | |
| − | [[Категория:Шаблоны:Внутренние ссылки|{{PAGENAME}}]]
| + | |
| − | | + | |
| − | [[be:Шаблон:Abbr]] | + | |
| − | [[en:Template:Abbr]]
| + | |
| − | [[eo:Ŝablono:Diskreta mallongigo]]
| + | |
| − | [[fr:Modèle:Abréviation]]
| + | |
| − | [[id:Templat:Abbr]]
| + | |
| − | [[ja:Template:Abbr]]
| + | |
| − | [[or:ଟେମ୍ପଲେଟ:Abbr]]
| + | |
| − | [[uk:Шаблон:Abbr]]
| + | |
| − | </includeonly> | + | |
Версия 10:14, 24 июля 2014
Включает подстраницу с документаций для текущего шаблона. Точнее, включает шаблон название страницы/doc. Работает также и в обсуждении шаблона, то есть включает одну и ту же страницу как из шаблона, так и из его обсуждения. И всё же включение документации в обсуждение является нежелательным.
Проще всего вставить вызов этого шаблона, а потом перейти по появившейся ссылке и создать или скопировать туда документацию. Достаточно добавить код <noinclude>{{doc}}</noinclude>.
Документация шаблона {{doc}} сформирована по тому же принципу, так что можно посмотреть код.
Основная цель выноса документации на отдельную страницу — избежать перегенерации HTML для всех страниц, использующих шаблон, при редактировании его документации. Также это сокращает страницу самого шаблона, что делает редактирование проще.
Шаблон поддерживает необязательный параметр. При вводе {{doc|Полное название страницы}} вместо страницы /doc будет включена любая необходимая. Это удобно для создания общей документации для однотипных шаблонов.
См. также Википедия:Проект:Документирование шаблонов|проект по документированию шаблонов.
Категория:Википедия:Шаблоны для документирования шаблонов|Abbr
