APRELKUN: Новая страница: «{{docpage}}Шаблон для автоматического добавления документации на страницы шаблонов.
{{Днш|Documentation|Template doc|Документация|Dokumentation}}
Включает для текущего шаблона подстраницу с документацией. Точнее, включает шаблон `название...»`


2024-06-12T09:24:00Z
Новая страница: «{{docpage}}Шаблон для автоматического добавления документации на страницы шаблонов.<hr>{{Днш|Documentation|Template doc|Документация|Dokumentation}}<hr>Включает для текущего шаблона подстраницу с документацией. Точнее, включает шаблон <code style="white-space:nowrap"><span style="opacity:0.5">название...»
Новая страница
{{docpage}}Шаблон для автоматического добавления документации на страницы шаблонов.<hr>{{Днш|Documentation|Template doc|Документация|Dokumentation}}<hr>Включает для текущего шаблона подстраницу с документацией. Точнее, включает шаблон <code style="white-space:nowrap"><span style="opacity:0.5">название страницы</span>/doc</code>. Работает также и в обсуждении шаблона, то есть включает одну и ту же страницу как из шаблона, так и из его обсуждения. И всё же включение документации в обсуждение является нежелательным. Основная цель выноса документации на отдельную страницу — избежать перегенерации HTML для всех страниц, использующих шаблон, при редактировании его документации. Также это сокращает страницу самого шаблона, что делает редактирование проще. Документация шаблона {{tl|doc}} сформирована по тому же принципу, так что можно посмотреть код.<p>Проще всего вставить вызов этого шаблона, а потом перейти по появившейся ссылке и создать или скопировать туда документацию. Достаточно добавить код <code style="white-space:nowrap"><nowiki>&lt;noinclude&gt;{{doc}}&lt;/noinclude&gt;</nowiki></code>.Шаблон {{Tl|doc}} добавляется в код других шаблонов, обычно в конце, без перевода строки:</p><p align="center"><code><nowiki><noinclude>{{doc}}</noinclude></nowiki></code></p>При этом на странице шаблона <code>Шаблон:Имя шаблона</code> отображается его документация — соответствующая подстраница <code>Шаблон:Имя шаблона/doc</code>, если она создана, или сообщение об отсутствии документации со ссылкой к её созданию, если не создана.<hr>К шаблону можно добавить документацию от другого шаблона. Для этого надо указать в коде шаблона {{Tl|doc}}, добавляемого в шаблон, полное имя нужной страницы документации. Шаблон поддерживает необязательный параметр. При вводе {{tlp|doc|Полное название страницы}} вместо страницы <code>/doc</code> будет включена любая необходимая. Это удобно для создания общей документации для однотипных шаблонов. Например, чтобы добавить к шаблону <code>Шаблон:Имя шаблона</code> страницу документации от шаблона <code>Шаблон:Имя шаблона 2</code>, нужно в код шаблона <code>Шаблон:Имя шаблона</code> добавить:<p align="center"><code><nowiki><noinclude>{{doc|Шаблон:Имя шаблона 2/doc}}</noinclude></nowiki></code><p>Страница от шаблона <code>Шаблон:Имя шаблона 2</code> будет добавлена в <code>Шаблон:Имя шаблона</code>, если она существует.<hr>Частью шаблона {{Tl|doc}} являются подшаблоны {{Tl|doc/begin}} и {{Tl|doc/end}}. Приглашение создать отсутствующую документацию задаётся с помощью шаблона {{Tl|Документируйте}}.<hr>См. также {{Tl|docpage}} — шаблон, добавляемый на страницы документации.{{Шаблоны для документирования шаблонов}}<includeonly>[[Категория:Шаблоны:Для документирования шаблонов]]</includeonly>
Шаблон:Doc/doc - История изменений
