Ҡалып:Pre/doc

Ҡалып:Pre · Документация · Фекер алышыу · Ҡайҙа ҡулланыла (Ҡалыпты ҡулланыу ^{параметрҙары})

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

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

Пример

Разметка

Выполнит как

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

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

Детали

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

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

Если содержимое начинается с пробела(-ов) используйте   вместо первого из них, чтобы текст был выведен правильно.
Используйте {{!}} вместо вертикальной черты, если вам нужно, чтобы не съедались пробелы до неё. В обратном случае вертикальную черту можно использовать до 19 раз.

Использование в документациях шаблонов

Шаблон может быть использован для создания примеров использования шаблонов в их документациях. Для этого вы можете задать параметр |t= с именем шаблона (которое можно не указывать, и тогда оно будет взято из названия текущей страницы). Например, чтобы показать синтаксис шаблона {{moved from}}, мы можем написать так:

{{pre|t=|''Вики-страница''{{notreq|''подпись и/или текст в конце''|текст{{=}}''Текст вместо «Перенесено со страницы»''}}}}
{{notreq/comment}}

и получим:

{{moved from|Вики-страница|подпись и/или текст в конце|текст=Текст вместо «Перенесено со страницы»}}

Необязательные параметры даны серым.

Про такой стиль оформления синтаксисов шаблонов в документациях см. Ҡалып:Tc#В оформлении документации.

Между тем, в многострочных примерах этот шаблон лучше не использовать по упомянутой выше причине съедания пробелов до вертикальных чёрт, прибегая вместо него к оформлению при помощи пробелов в начале строки, которые также позволяют включать разметку в код. Например, что может быть проще, чем следующий код (в начале каждой строки — пробел):

 {{((}}main
  |''Статья 1''
  |''Статья 2''
  |l1=''Отображаемый текст ссылки 1''
  |l2=''Отображаемый текст ссылки 2''
 }}

который даст:

{{main
 |Статья 1
 |Статья 2
 |l1=Отображаемый текст ссылки 1
 |l2=Отображаемый текст ссылки 2
}}

Для возможности вставки буллитов перед полями с кодом используйте шаблон {{*pre}}.

См. также

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