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

{{Docpage}}
__NOTOC__
{{Эзотерический шаблон}}
Этот шаблон реализует функциональные возможности [[HTML]]-тега {{Tago|Pre}}, который выводит блок предварительно отформатированного текста. Такой текст отображается моноширинным шрифтом со всеми пробелами между словами. По умолчанию любое количество пробелов идущих подряд показывается как один. Тег {{Tago|Pre}} позволяет обойти эту особенность и отображает текст как требуется разработчику.

'''Важное замечание:''' этот шаблон, в отличие от простого тега {{Tago|Pre}} (см. [[Википедия:Как править статьи]]), позволяет включать в себя разметку, которая будет обрабатываться соответствующим образом, прежде чем поместить результат в теги {{Tag|Pre}}.

Также он полезен в обсуждениях: содержимое тега {{Tago|Pre}}, помещённое не на первый уровень обсуждения, выйдет из-под области действия текстового поля, начиная со второй строки, а содержимое шаблона (если поместить его в теги {{Tag|nowiki}}) — нет.

== Пример ==
{{Markup
|<nowiki>
{{Pre|
                 и выше
               и выше,
     Всё  выше 
Стремим мы полёт наших птиц,
  И в каждом пропеллере дышит
     Спокойствие 
                 наших 
                       границ.
}}</nowiki>

|
{{Pre|
                 и выше
               и выше,
     Всё  выше 
Стремим мы полёт наших птиц,
  И в каждом пропеллере дышит
     Спокойствие 
                 наших 
                       границ.
}}
}}

== Детали ==
* Можно задать параметры {{Para|width}} и {{Para|space}}, которые подставятся в качестве значений [[CSS]]-свойств ''width'' и ''white-space'' (настройка ширины поля и режима переноса строк). В параметре {{Para|style}} можно задать дополнительные настройки стиля.

Ограничения (вытекающие из отличий [[Википедия:Механизм шаблонов|механизма шаблонов]] от тегов):
* Если в тексте используются знаки равенства, поставьте <code>1=</code> в начало содержимого параметра, используйте {{Tag|nowiki}} или замените знаки равенства на {{Tcl|=}}.
* Используйте {{Tcl|!}} вместо вертикальной черты, если вам нужно, чтобы не съедались пробелы до неё. В обратном случае вертикальную черту можно использовать до 19 раз.

== См. также ==
* {{T|*pre}} — делает возможным использовать тег {{Tago|Pre}} с маркерами списка
* {{Xtag|syntaxhighlight|style=regular}}
* {{T|Sp-down}} — отбитая от левого края стрелка вниз, чтобы оформить ею результат обработки того, что показано в шаблоне {{T|Pre}}
* {{T|Tpre}} — для создания примеров использования шаблонов в их документациях

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