Шаблон:Doc/doc: различия между версиями
(Первая версия документа) |
м (добавлен ссылка на источник вдохновения: откуда взят данный шаблон) |
||
Строка 1: | Строка 1: | ||
Шаблон Doc взят из русской википедии. См. тут: [[wikipedia:Шаблон:Doc]] | |||
Включает подстраницу с документацией для текущего шаблона. | Включает подстраницу с документацией для текущего шаблона. | ||
Текущая версия от 17:15, 22 ноября 2014
Шаблон Doc взят из русской википедии. См. тут: wikipedia:Шаблон:Doc
Включает подстраницу с документацией для текущего шаблона.
Основная цель выноса документации на отдельную страницу — избежать перегенерации HTML для всех страниц, использующих шаблон, при редактировании его документации. Также это сокращает страницу самого шаблона, что делает редактирование проще.
Некоторые шаблоны (редкоизменяемые) проще документировать с использованием конструкции <noinclude></noinclude>
, чем выносить документацию в отдельную страницу.
Документация располагается всегда в файле название страницы/doc
и шаблон Doc, фактически, подключает страницу с таким именем.
Проще всего вставить вызов этого шаблона, а потом перейти по появившейся ссылке и создать или скопировать туда документацию. Достаточно добавить код <noinclude>{{doc}}</noinclude>
.