Шаблон:Pre/doc: различия между версиями
Перейти к навигации
Перейти к поиску
Mansur700 (обсуждение | вклад) (Новая страница: «{{docpage}}__NOTOC__ Этот шаблон реализует функциональные возможности HTML-тега {{tago|pre}}, который...») |
Adam (обсуждение | вклад) Нет описания правки |
||
| Строка 1: | Строка 1: | ||
{{docpage}}__NOTOC__ | {{docpage}} | ||
__NOTOC__ | |||
{{Эзотерический шаблон}} | |||
Этот шаблон реализует функциональные возможности [[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: | Строка 38: | ||
* Можно задать параметры {{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 раз. | ||
Текущая версия от 00:31, 6 февраля 2022
 |
 | Этот шаблон использует некоторые чрезвычайно сложные и эзотерические свойства языка шаблонов. |
Этот шаблон реализует функциональные возможности 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}} — для создания примеров использования шаблонов в их документациях