Шаблон:Pre/doc

Этот шаблон использует некоторые чрезвычайно сложные и эзотерические свойства языка шаблонов.

Пожалуйста, не пытайтесь изменять его до тех пор, пока:

1. Вы до конца не поймёте, как он устроен.
2. Вы не будете готовы к устранению любых последствий в случае неожиданного результата.

Эксперименты следует проводить в песочнице или вашем личном пространстве.

Этот шаблон реализует функциональные возможности 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-down}} — отбитая от левого края стрелка вниз, чтобы оформить ею результат обработки того, что показано в шаблоне {{Pre}}
{{Tpre}} — для создания примеров использования шаблонов в их документациях