Шаблон:Pre/doc

Этот шаблон реализует функциональные возможности HTML-тега <pre>, который выводит блок предварительно отформатированного текста. Такой текст отображается моноширинным шрифтом со всеми пробелами между словами. По умолчанию любое количество пробелов идущих подряд показывается как один. Тег <pre> позволяет обойти эту особенность и отображает текст как требуется разработчику.

Важное замечание: этот шаблон, в отличие от простого тега <pre> (см. Википедия:Как править статьи), позволяет включать в себя разметку, которая будет обрабатываться соответствующим образом, прежде чем поместить результат в теги <pre></pre>.

Также он полезен в обсуждениях: содержимое тега <pre>, помещённое не на первый уровень обсуждения, выйдет из-под области действия текстового поля, начиная со второй строки, а содержимое шаблона (если поместить его в теги <nowiki></nowiki>) — нет.

Пример

Разметка

Выполнит как

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

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

Детали

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

Ограничения (вытекающие из отличий механизма шаблонов от тегов):

Если в тексте используются знаки равенства, поставьте 1= в начало содержимого параметра, используйте <nowiki></nowiki> или замените знаки равенства на {{=}}.
Используйте {{!}} вместо вертикальной черты, если вам нужно, чтобы не съедались пробелы до неё. В обратном случае вертикальную черту можно использовать до 19 раз.

См. также

{{*pre}} — делает возможным использовать тег <pre> с маркерами списка
<syntaxhighlight>
{{sp↓}} — отбитая от левого края стрелка вниз, чтобы оформить ею результат обработки того, что показано в шаблоне {{pre}}
{{tpre}} — для создания примеров использования шаблонов в их документациях