Ҡалып:Pre/doc
Этот шаблон реализует функциональные возможности 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}}