Редактирование: Шаблон:Tpre/doc

{{Docpage}}
{{OnLua|Template call code|withParams}}
'''{{Tl|Tpre}}''' совмещает в себе функцию {{Tl|Tc}} и {{Tl|Pre}}. С его помощью удобно создавать примеры использования шаблонов в их документациях.

Например, чтобы показать синтаксис шаблона {{Tl|Перенесено с}}, мы можем в его документации написать так:
<dl><dd><pre>{{Tpre||''Вики-страница''{{Optp|''подпись и/или текст в конце''|текст{{=}}''Текст вместо «Перенесено со страницы»''}}}}
{{Optp/comment}}</pre></dd></dl>
и получим:
: {{Tpre|Перенесено с|''Вики-страница''{{Optp|''подпись и/или текст в конце''|текст{{=}}''Текст вместо «Перенесено со страницы»''}}}}
: {{Optp/comment}}

{{^}}
Про такой стиль оформления синтаксисов шаблонов в документациях см. {{Ссылка на раздел|Шаблон:Tc#В оформлении документации}}.

Между тем в многострочных примерах этот шаблон лучше не использовать по причине съедания пробелов до вертикальных черт, прибегая вместо него к оформлению при помощи пробела в начале строк. Это тоже позволяет включать разметку в код. Например (в начале каждой строки — пробел):
<pre>
 {{((}}main
  |''Статья 1''
  |''Статья 2''
  |l1=''Отображаемый текст ссылки 1''
  |l2=''Отображаемый текст ссылки 2''
 }}
</pre>
который даст:
 {{((}}main
  |''Статья 1''
  |''Статья 2''
  |l1=''Отображаемый текст ссылки 1''
  |l2=''Отображаемый текст ссылки 2''
 }}

=== Настройки ===
Если задать {{Para|_spaced|1}}, параметры шаблона будут отбиты пробелами:

{{Пример||ш|параметр 1{{((}}{{=}}{{))}}значение|параметр 2{{((}}{{=}}{{))}}значение|_spaced{{=}}1|_tag=pre|_sep={{Sp-down}}}}

== См. также ==
* {{Tl|*tpre}} — то же самое с маркером списка (иначе его нельзя использовать напрямую)
* {{Tl|Sp-down}} — отбитая от левого края стрелка вниз, чтобы оформить ею результат обработки того, что показано в шаблоне {{Tl|Tpre}}
* {{Tl|Пример}} — <code>код вызова шаблона</code> → результат; см. там стиль <code>pre</code>
* {{Tl|Pre}}
* {{Tl|Между pre}}

{{Шаблоны для документирования}}

<includeonly>
[[Категория:Шаблоны:Для документирования шаблонов]]
</includeonly>