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

Материал из Chaotic Onyx
Перейти к навигацииПерейти к поиску
(Позаимствовано: https://www.underrail.com/wiki/index.php?title=Template:Documentation/doc)
 
(Перевод с буржуйского и модификация по MOC'у в своей голове)
Строка 1: Строка 1:
−
==Description==
+
== Описание ==
  
−
This template is used to insert descriptions on template pages.
+
Этот шаблон используется для вставки описаний на страницах шаблонов.
  
−
==Syntax==
+
== Синтаксис ==
  
−
Add <code><nowiki><noinclude></nowiki>{{t|documentation}}<nowiki></noinclude></nowiki></code> at the end of the template page.
+
Добавьте <code><nowiki><noinclude></nowiki>{{t|documentation}}<nowiki></noinclude></nowiki></code> в конце страницы шаблона.
  
−
==Usage==
+
== Использование ==
  
−
===On the Template page===
+
=== На странице Шаблона ===
  
−
This is the normal format when used:
+
Это нормальный формат при использовании:
  
 
<pre>
 
<pre>
  
−
TEMPLATE CODE<includeonly>Any categories to be inserted into articles by the template</includeonly><noinclude>
+
КОД ШАБЛОНА<includeonly>Любые категории для вставки в статьи по шаблону</includeonly><noinclude>
  
 
{{documentation}}</noinclude>
 
{{documentation}}</noinclude>
Строка 21: Строка 21:
 
</pre>
 
</pre>
  
−
''If your template is not a completed div or table, you may need to close the tags just before <code><nowiki>{{documentation}}</nowiki></code> is inserted (within the noinclude tags).''
+
''Если ваш шаблон не является законченным [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]).''
  
−
''A line break right before <code><nowiki>{{documentation}}</nowiki></code> can also be useful as it helps prevent the documentation template "running into" previous code.''
+
''Разрыв строки прямо перед <code><nowiki>{{documentation}}</nowiki></code> также может быть полезным, так как это помогает предотвратить "столкновение" шаблона документации с предыдущим кодом.''
  
−
===On the Template/doc page===
+
=== На странице Template/doc ===
  
−
Normally, you will want to write something like the following on the documentation page:
+
Обычно вы захотите написать что-то вроде следующего на странице документации:
  
 
<pre>
 
<pre>
  
−
==Description==
+
== Описание ==
  
−
This template is used to do something.
+
Этот шаблон используется, чтобы сделать что-то.
  
−
==Syntax==
+
== Синтаксис ==
  
−
Type <code>{{t|templatename}}</code> somewhere.
+
Напишите <code>{{t|templatename}}</code> где-то.
  
−
==Samples==
+
== Примеры ==
  
 
<code>&lt;nowiki>{{templatename|input}}&lt;/nowiki></code>
 
<code>&lt;nowiki>{{templatename|input}}&lt;/nowiki></code>
  
−
results in...
+
превращается в...
  
 
{{templatename|input}}
 
{{templatename|input}}
  
−
<includeonly>Any categories for the template itself</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
+
<includeonly>Любые категории для самого шаблона</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
  
 
</pre>
 
</pre>
  
−
Use any or all of the above description/syntax/sample output sections. You may also want to add "see also" or other sections.
+
Используйте любой или все вышеприведенные разделы [[#Описание|описания]]/[[#Синтаксис|синтаксиса]]/[[#Использование|примера вывода]]. Вы также можете добавить «См. также» или другие разделы.
  
−
Note that the above example also uses the [[Template:T]] and [[Template:T/piece]] templates.
+
Обратите внимание, что в приведенном выше примере также используется шаблоны [[Template:T]] и [[Template:T/piece]].
  
 
<includeonly>[[Category:General wiki templates|{{PAGENAME}}]]</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
 
<includeonly>[[Category:General wiki templates|{{PAGENAME}}]]</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>

Версия от 13:46, 2 июля 2020

Описание

Этот шаблон используется для вставки описаний на страницах шаблонов.

Синтаксис

Добавьте <noinclude>{{ documentation }}</noinclude> в конце страницы шаблона.

Использование

На странице Шаблона

Это нормальный формат при использовании: 


КОД ШАБЛОНА<includeonly>Любые категории для вставки в статьи по шаблону</includeonly><noinclude>

{{documentation}}</noinclude>

Если ваш шаблон не является законченным div или table, то, возможно, вам потребуется закрыть теги непосредственно перед вставкой {{documentation}} (в пределах тегов noinclude).

Разрыв строки прямо перед {{documentation}} также может быть полезным, так как это помогает предотвратить "столкновение" шаблона документации с предыдущим кодом.

На странице Template/doc

Обычно вы захотите написать что-то вроде следующего на странице документации: 


== Описание ==

Этот шаблон используется, чтобы сделать что-то.

== Синтаксис ==

Напишите <code>{{t|templatename}}</code> где-то.

== Примеры ==

<code><nowiki>{{templatename|input}}</nowiki></code>

превращается в...

{{templatename|input}}

<includeonly>Любые категории для самого шаблона</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>

Используйте любой или все вышеприведенные разделы описания/синтаксиса/примера вывода. Вы также можете добавить «См. также» или другие разделы.

Обратите внимание, что в приведенном выше примере также используется шаблоны Template:T и Template:T/piece.

Источник — https://wiki.ss13.ru/index.php?title=Шаблон:Documentation/doc&oldid=32115