Шаблон:Documentation/doc: различия между версиями
Материал из Animus
Перейти к навигацииПерейти к поиску (Перевод с буржуйского и модификация по MOC'у в своей голове) |
(Модернизация содержания страницы) |
||
| Строка 5: | Строка 5: | ||
== Синтаксис == | == Синтаксис == | ||
| − | Добавьте <code><nowiki><noinclude></nowiki>{{t| | + | Добавьте <code><nowiki><noinclude></nowiki>{{ t|Documentation }}<nowiki></noinclude></nowiki></code> в конце страницы шаблона. |
== Использование == | == Использование == | ||
| Строка 15: | Строка 15: | ||
<pre> | <pre> | ||
| − | + | КОД_ШАБЛОНА<includeonly>Любые категории для вставки в статьи по шаблону</includeonly><noinclude> | |
| − | {{ | + | {{ Template: Documentation }}</noinclude> |
</pre> | </pre> | ||
| Строка 23: | Строка 23: | ||
''Если ваш шаблон не является законченным [http://htmlbook.ru/html/div div] или [http://htmlbook.ru/html/table table], то, возможно, вам потребуется закрыть теги непосредственно перед вставкой <code><nowiki>{{documentation}}</nowiki></code> (в пределах тегов [https://ru.wikipedia.org/wiki/Википедия:Механизм_шаблонов#Теги_noinclude,_includeonly,_onlyinclude noinclude]).'' | ''Если ваш шаблон не является законченным [http://htmlbook.ru/html/div div] или [http://htmlbook.ru/html/table table], то, возможно, вам потребуется закрыть теги непосредственно перед вставкой <code><nowiki>{{documentation}}</nowiki></code> (в пределах тегов [https://ru.wikipedia.org/wiki/Википедия:Механизм_шаблонов#Теги_noinclude,_includeonly,_onlyinclude noinclude]).'' | ||
| − | ''Разрыв строки прямо перед <code><nowiki>{{ | + | ''Разрыв строки прямо перед <code><nowiki>{{ Template: Documentation }}</nowiki></code> также может быть полезным, так как это помогает предотвратить "столкновение" шаблона документации с предыдущим кодом.'' |
=== На странице Template/doc === | === На странице Template/doc === | ||
| Строка 37: | Строка 37: | ||
== Синтаксис == | == Синтаксис == | ||
| − | Напишите <code>{{t| | + | Напишите <code>{{t|имя_шаблона}}</code> в необходимом месте. |
| + | |||
| + | Например, [[ Article_management_templates|Шаблоны управления страницами ]] — преимущественно, сверху. | ||
| + | |||
| + | На страницах не принято дублировать одинаковые шаблоны. | ||
| + | |||
| + | Вставить шаблон можно несколькими способами. | ||
== Примеры == | == Примеры == | ||
| − | <code> | + | === Без использования параметров === |
| + | : <code><nowiki>{{ Template: имя_шаблона }}</nowiki></code> | ||
превращается в... | превращается в... | ||
| − | {{ | + | {{ Template: имя_шаблона }} |
| + | |||
| + | === С использованием параметров === | ||
| + | : <code><nowiki>{{ Template: имя_шаблона|вводные_параметры }}</nowiki></code> | ||
| + | |||
| + | превращается в... | ||
| + | |||
| + | {{ Template: имя_шаблона|вводные_параметры }} | ||
| + | |||
| + | === Параметры === | ||
| + | {| border="1" class="wikitable sortable" | ||
| + | |- | ||
| + | | | ||
| + | * '''param1''' | ||
| + | | | ||
| + | Описание параметра №1. | ||
| + | |- | ||
| + | | | ||
| + | * '''param2''' | ||
| + | | | ||
| + | Описание параметра №2. | ||
| + | |} | ||
| + | |||
| + | |||
| + | <code><nowiki> <includeonly>Любые категории для самого шаблона</includeonly><noinclude>[[ Category:Template documentation|{{PAGENAME}} ]]</noinclude> </nowiki></code> | ||
| + | |||
| + | Например… | ||
| − | <includeonly> | + | <includeonly>[[ Category: Article_management_templates ]]</includeonly><noinclude>[[ Category: Template_documentation|{{PAGENAME}} ]]</noinclude> |
</pre> | </pre> | ||
| Строка 55: | Строка 88: | ||
Обратите внимание, что в приведенном выше примере также используется шаблоны [[Template:T]] и [[Template:T/piece]]. | Обратите внимание, что в приведенном выше примере также используется шаблоны [[Template:T]] и [[Template:T/piece]]. | ||
| − | <includeonly>[[Category: | + | <includeonly> [[ Category: General_wiki_templates|{{PAGENAME}} ]]</includeonly><noinclude>[[ Category: Template_documentation|{{PAGENAME}} ]]</noinclude> |
Версия от 12:12, 22 июля 2020
Описание
Этот шаблон используется для вставки описаний на страницах шаблонов.
Синтаксис
Добавьте <noinclude>{{
Documentation
}}</noinclude> в конце страницы шаблона.
Использование
На странице Шаблона
Это нормальный формат при использовании:
КОД_ШАБЛОНА<includeonly>Любые категории для вставки в статьи по шаблону</includeonly><noinclude>
{{ Template: Documentation }}</noinclude>
Если ваш шаблон не является законченным div или table, то, возможно, вам потребуется закрыть теги непосредственно перед вставкой {{documentation}} (в пределах тегов noinclude).
Разрыв строки прямо перед {{ Template: Documentation }} также может быть полезным, так как это помогает предотвратить "столкновение" шаблона документации с предыдущим кодом.
На странице Template/doc
Обычно вы захотите написать что-то вроде следующего на странице документации:
== Описание ==
Этот шаблон используется, чтобы сделать что-то.
== Синтаксис ==
Напишите <code>{{t|имя_шаблона}}</code> в необходимом месте.
Например, [[ Article_management_templates|Шаблоны управления страницами ]] — преимущественно, сверху.
На страницах не принято дублировать одинаковые шаблоны.
Вставить шаблон можно несколькими способами.
== Примеры ==
=== Без использования параметров ===
: <code>{{ Template: имя_шаблона }}</code>
превращается в...
{{ Template: имя_шаблона }}
=== С использованием параметров ===
: <code>{{ Template: имя_шаблона|вводные_параметры }}</code>
превращается в...
{{ Template: имя_шаблона|вводные_параметры }}
=== Параметры ===
{| border="1" class="wikitable sortable"
|-
|
* '''param1'''
|
Описание параметра №1.
|-
|
* '''param2'''
|
Описание параметра №2.
|}
<code> <includeonly>Любые категории для самого шаблона</includeonly><noinclude>[[ Category:Template documentation|{{PAGENAME}} ]]</noinclude> </code>
Например…
<includeonly>[[ Category: Article_management_templates ]]</includeonly><noinclude>[[ Category: Template_documentation|{{PAGENAME}} ]]</noinclude>
Используйте любой или все вышеприведенные разделы описания/синтаксиса/примера вывода. Вы также можете добавить «См. также» или другие разделы.
Обратите внимание, что в приведенном выше примере также используется шаблоны Template:T и Template:T/piece.
