Шаблон:Pre/doc: различия между версиями

Материал из Тептар — свободной энциклопедии
Перейти к навигации Перейти к поиску
(Новая страница: «{{docpage}}__NOTOC__ Этот шаблон реализует функциональные возможности HTML-тега {{tago|pre}}, который...»)
 
Нет описания правки
 
Строка 1: Строка 1:
{{docpage}}__NOTOC__
{{docpage}}
__NOTOC__
{{Эзотерический шаблон}}
Этот шаблон реализует функциональные возможности [[HTML]]-тега {{tago|pre}}, который выводит блок предварительно отформатированного текста. Такой текст отображается моноширинным шрифтом со всеми пробелами между словами. По умолчанию любое количество пробелов идущих подряд показывается как один. Тег {{tago|pre}} позволяет обойти эту особенность и отображает текст как требуется разработчику.
Этот шаблон реализует функциональные возможности [[HTML]]-тега {{tago|pre}}, который выводит блок предварительно отформатированного текста. Такой текст отображается моноширинным шрифтом со всеми пробелами между словами. По умолчанию любое количество пробелов идущих подряд показывается как один. Тег {{tago|pre}} позволяет обойти эту особенность и отображает текст как требуется разработчику.


'''Важное замечание:''' этот шаблон, в отличие от простого тега {{tago|pre}} (см. [[Википедия:Как править статьи]]), позволяет включать в себя разметку, которая будет обрабатываться соответствующим образом, прежде чем поместить результат в теги {{tag|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}} — для создания примеров использования шаблонов в их документациях