Шаблон:Pre/doc: различия между версиями
Перейти к навигации
Перейти к поиску
| [непроверенная версия] | [отпатрулированная версия] |
Нет описания правки |
Нет описания правки |
||
| (не показана 1 промежуточная версия этого же участника) | |||
| Строка 2: | Строка 2: | ||
Этот шаблон реализует функциональные возможности HTML-тега {{tago|pre}}, который выводит блок предварительно отформатированного текста. Такой текст отображается моноширинным шрифтом со всеми пробелами между словами. По умолчанию любое количество пробелов идущих подряд показывается как один. Тег {{tago|pre}} позволяет обойти эту особенность и отображает текст как требуется разработчику. | Этот шаблон реализует функциональные возможности 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|=}}. | ||
* Используйте {{ | * Используйте <nowiki>{{!}}</nowiki> вместо вертикальной черты, если вам нужно, чтобы не съедались пробелы до неё. В обратном случае вертикальную черту можно использовать до 19 раз. | ||
<includeonly> | <includeonly> | ||
Текущая версия от 08:38, 22 апреля 2019
Этот шаблон реализует функциональные возможности HTML-тега <pre>, который выводит блок предварительно отформатированного текста. Такой текст отображается моноширинным шрифтом со всеми пробелами между словами. По умолчанию любое количество пробелов идущих подряд показывается как один. Тег <pre> позволяет обойти эту особенность и отображает текст как требуется разработчику.
Важное замечание: этот шаблон, в отличие от простого тега <pre>, позволяет включать в себя разметку, которая будет обрабатываться соответствующим образом, прежде чем поместить результат в теги <pre>...</pre>.
Также он полезен в обсуждениях: содержимое тега <pre>, помещённое не на первый уровень обсуждения, выйдет из-под области действия текстового поля, начиная со второй строки, а содержимое шаблона (если поместить его в теги <nowiki>...</nowiki>) — нет.
Пример[править код]
| Разметка | Выполнит как |
|---|---|
{{pre|
и выше
и выше,
Всё выше
Стремим мы полёт наших птиц,
И в каждом пропеллере дышит
Спокойствие
наших
границ.
}}
|
и выше
и выше,
Всё выше
Стремим мы полёт наших птиц,
И в каждом пропеллере дышит
Спокойствие
наших
границ. |
Детали[править код]
- Можно задать параметры
|width=и|space=, которые подставятся в качестве значений CSS-свойств width и white-space (настройка ширины поля и режима переноса строк). В параметре|style=можно задать дополнительные настройки стиля.
Ограничения (вытекающие из отличий механизма шаблонов от тегов):
- Если в тексте используются знаки равенства, поставьте
1=в начало содержимого параметра, используйте<nowiki>...</nowiki>или замените знаки равенства на{{=}}. - Используйте {{!}} вместо вертикальной черты, если вам нужно, чтобы не съедались пробелы до неё. В обратном случае вертикальную черту можно использовать до 19 раз.