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

Материал из Space Station 14 Вики
м docpage there
мНет описания правки
 
(не показаны 2 промежуточные версии 2 участников)
Строка 1: Строка 1:
{{docpage}}
{{docpage}}
docpage there
{{стили шаблона|Шаблон:Doc/styles.css}}
Включает подстраницу с документацией для текущего шаблона. Точнее, включает страницу «''Название текущей страницы''/doc». Работает также и в обсуждении шаблона, то есть включает одну и ту же страницу как из шаблона, так и из его обсуждения (хотя включение документации в обсуждение является нежелательным).
 
Проще всего вставить включение этого шаблона, а потом перейти по появившейся ссылке и создать или скопировать туда документацию. Достаточно добавить код <code class="nowrap"><nowiki>&lt;noinclude&gt;{{doc}}&lt;/noinclude&gt;</nowiki></code>, '''не перенося строку''' после последней строчки кода шаблона.
 
Документация шаблона {{t|doc}} сформирована по тому же принципу, так что можно посмотреть код.
 
Основная цель выноса документации на отдельную страницу — избежать [https://w.wiki/Diky перегенерации HTML] для всех страниц, использующих шаблон, при редактировании его документации. Также это сокращает страницу самого шаблона, что делает редактирование проще.
 
Шаблон поддерживает необязательный параметр. При вводе {{tc|doc|''Полное название страницы''}} вместо страницы «/doc» будет включена любая необходимая. Это удобно для создания общей документации для однотипных шаблонов.
 
== См. также ==
* Пара шаблонов {{tl|doc-inline}} и {{tl|doc-end}}
 
== TemplateData ==
<templatedata>
{
"params": {
"1": {},
"2": {},
"3": {},
"4": {},
"5": {},
"SUBJECTPAGENAME": {}
},
"format": "block"
}
</templatedata>
 
<includeonly>
[[Категория:Шаблоны:Для документирования шаблонов]]
</includeonly>

Текущая версия от 06:45, 6 апреля 2025

Включает подстраницу с документацией для текущего шаблона. Точнее, включает страницу «Название текущей страницы/doc». Работает также и в обсуждении шаблона, то есть включает одну и ту же страницу как из шаблона, так и из его обсуждения (хотя включение документации в обсуждение является нежелательным).

Проще всего вставить включение этого шаблона, а потом перейти по появившейся ссылке и создать или скопировать туда документацию. Достаточно добавить код <noinclude>{{doc}}</noinclude>, не перенося строку после последней строчки кода шаблона.

Документация шаблона {{doc}} сформирована по тому же принципу, так что можно посмотреть код.

Основная цель выноса документации на отдельную страницу — избежать перегенерации HTML для всех страниц, использующих шаблон, при редактировании его документации. Также это сокращает страницу самого шаблона, что делает редактирование проще.

Шаблон поддерживает необязательный параметр. При вводе {{doc|Полное название страницы}} вместо страницы «/doc» будет включена любая необходимая. Это удобно для создания общей документации для однотипных шаблонов.

См. также

TemplateData

Нет описания.

Параметры шаблона

Шаблон использует блочное форматирование параметров.

ПараметрОписаниеТипСтатус
11

без описания

Неизвестнонеобязательный
22

без описания

Неизвестнонеобязательный
33

без описания

Неизвестнонеобязательный
44

без описания

Неизвестнонеобязательный
55

без описания

Неизвестнонеобязательный
SUBJECTPAGENAMESUBJECTPAGENAME

без описания

Неизвестнонеобязательный