Шаблон:Pre/doc

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

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

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

Детали

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

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

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

См. также

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