Шаблон:Pre/doc — различия между версиями
Alexandre (обсуждение | вклад) (Новая страница: «<noinclude>{{docpage}}</noinclude>__NOTOC__ Этот шаблон реализует функциональные возможности HTML-тега {{tago|…») |
Alexandre (обсуждение | вклад) |
||
Строка 1: | Строка 1: | ||
<noinclude>{{docpage}}</noinclude>__NOTOC__ | <noinclude>{{docpage}}</noinclude>__NOTOC__ | ||
− | Этот шаблон реализует функциональные возможности | + | Этот шаблон реализует функциональные возможности HTML-тега {{tago|pre}}, который выводит блок предварительно отформатированного текста. Такой текст отображается моноширинным шрифтом со всеми пробелами между словами. По умолчанию любое количество пробелов идущих подряд показывается как один. Тег {{tago|pre}} позволяет обойти эту особенность и отображает текст как требуется разработчику. |
− | '''Важное замечание:''' этот шаблон, в отличие от простого тега {{tago|pre}} | + | '''Важное замечание:''' этот шаблон, в отличие от простого тега {{tago|pre}}, позволяет включать в себя разметку, которая будет обрабатываться соответствующим образом, прежде чем поместить результат в теги {{tag|pre}}. |
Также он полезен в обсуждениях: содержимое тега {{tago|pre}}, помещённое не на первый уровень обсуждения, выйдет из-под области действия текстового поля, начиная со второй строки, а содержимое шаблона (если поместить его в теги {{tag|nowiki}}) — нет. | Также он полезен в обсуждениях: содержимое тега {{tago|pre}}, помещённое не на первый уровень обсуждения, выйдет из-под области действия текстового поля, начиная со второй строки, а содержимое шаблона (если поместить его в теги {{tag|nowiki}}) — нет. | ||
Строка 36: | Строка 36: | ||
* Можно задать параметры {{para|width}} и {{para|space}}, которые подставятся в качестве значений [[CSS]]-свойств ''width'' и ''white-space'' (настройка ширины поля и режима переноса строк). В параметре {{para|style}} можно задать дополнительные настройки стиля. | * Можно задать параметры {{para|width}} и {{para|space}}, которые подставятся в качестве значений [[CSS]]-свойств ''width'' и ''white-space'' (настройка ширины поля и режима переноса строк). В параметре {{para|style}} можно задать дополнительные настройки стиля. | ||
− | Ограничения (вытекающие из отличий | + | Ограничения (вытекающие из отличий механизма шаблонов от тегов): |
* Если в тексте используются знаки равенства, поставьте <code>1=</code> в начало содержимого параметра, используйте {{tag|nowiki}} или замените знаки равенства на {{tcl|=}}. | * Если в тексте используются знаки равенства, поставьте <code>1=</code> в начало содержимого параметра, используйте {{tag|nowiki}} или замените знаки равенства на {{tcl|=}}. | ||
* Используйте {{tcl|!}} вместо вертикальной черты, если вам нужно, чтобы не съедались пробелы до неё. В обратном случае вертикальную черту можно использовать до 19 раз. | * Используйте {{tcl|!}} вместо вертикальной черты, если вам нужно, чтобы не съедались пробелы до неё. В обратном случае вертикальную черту можно использовать до 19 раз. |
Версия 14:49, 28 марта 2018
Этот шаблон реализует функциональные возможности 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}} — для создания примеров использования шаблонов в их документациях