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

Материал из Тептар — свободной энциклопедии
Перейти к навигации Перейти к поиску
(Новая страница: «{{docpage}} {{onLua|ExampleList}} Вызывает шаблон {{t|пример}} для каждого набора параметров, результаты...»)
 
Нет описания правки
 
Строка 5: Строка 5:
Параметры в этих наборах разделяются через <code>\</code>, сами наборы — через <code>|</code>. Название шаблона берётся из названия текущей страницы (до первого слэша), но его можно указать явно в параметре {{para|t}} ({{para|template}}).
Параметры в этих наборах разделяются через <code>\</code>, сами наборы — через <code>|</code>. Название шаблона берётся из названия текущей страницы (до первого слэша), но его можно указать явно в параметре {{para|t}} ({{para|template}}).


Доступны многие параметры, используемые в шаблоне {{t|пример}}, но без знака подчёркивания: {{para|style}}, {{para|sep}}, {{para|nobr}}, {{para|spaced}}, {{para|nocat}}, {{para|prefix}}, {{para|postfix}}. Внутри индивидуальных примеров — <code>\_prefix=</code>, <code>\_postfix=</code>, а также <code>\_comment=</code> (<code>\_after=</code>) и <code>\_before=</code> для комментария к примеру (но будьте внимательны со знаками равенства, см. ниже). Символ, с которого начинается строка, задаётся в параметре {{para|opener}} (по умолчанию — <code>*</code>). Вики-текст для вставки ''между'' примерами — в параметре {{para|between}} (например, {{tcl|^}}; по умолчанию — пустая строка; за исключением случая {{para|style|*pre}}: тогда используется значение {{tcl|^|3em}}).
Доступны многие параметры, используемые в шаблоне {{t|пример}}, но без знака подчёркивания: {{para|style}}, {{para|sep}}, {{para|nobr}}, {{para|spaced}}, {{para|nocat}}, {{para|prefix}}, {{para|postfix}}. Внутри индивидуальных примеров — <code>\_alias=</code>, <code>\_prefix=</code>, <code>\_postfix=</code>, а также <code>\_comment=</code>, <code>\_after=</code> и <code>\_before=</code> для комментария к примеру (но будьте внимательны со знаками равенства, см. ниже). Символ, с которого начинается строка, задаётся в параметре {{para|opener}} (по умолчанию — <code>*</code>). Тептар-текст для вставки ''между'' примерами — в параметре {{para|between}} (например, {{tcl|^}}; по умолчанию — пустая строка; за исключением случая {{para|style|*pre}}: тогда используется значение {{tcl|^|3em}}).


Также может использоваться с подстановкой.
Также может использоваться с подстановкой.
Строка 30: Строка 30:


В отличие от {{t|пример}}, {{t|tc}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте {{tlc|=}}. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте <code>&amp;#95;</code> вместо него. Если в примерах используется много именованных параметров, удобно использовать <code>''N''=</code> в начале строк для номеров параметров, например:
В отличие от {{t|пример}}, {{t|tc}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте {{tlc|=}}. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте <code>&amp;#95;</code> вместо него. Если в примерах используется много именованных параметров, удобно использовать <code>''N''=</code> в начале строк для номеров параметров, например:
<nowiki>{{стопка примеров|t=</nowiki>[[t:join|join]]<nowiki>|style=wikitable|spaced=1
<pre><nowiki>{{стопка примеров|t=</nowiki>[[t:join|join]]<nowiki>|style=wikitable|spaced=1
|1=1=abc = "foobar"; \2=def = "blah-blah-blah"; \3=jhi = "tram-pa-pam"; \separator=<br>
|1=1=abc = "foobar"; \2=def = "blah-blah-blah"; \3=jhi = "tram-pa-pam"; \separator=<br>
|2=1=abc = "foobar"; \2= \3=def = "blah-blah-blah"; \separator=<br>
|2=1=abc = "foobar"; \2= \3=def = "blah-blah-blah"; \separator=<br>
Строка 43: Строка 43:
По умолчанию у неименованных параметров (разделённых через <code>|</code>) обрезаются пробелы и переносы строки слева и справа. Чтобы отменить это поведение, используйте {{para|trim|0}}. Однако, если вы использовали <code>''N''=</code> в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер).
По умолчанию у неименованных параметров (разделённых через <code>|</code>) обрезаются пробелы и переносы строки слева и справа. Чтобы отменить это поведение, используйте {{para|trim|0}}. Однако, если вы использовали <code>''N''=</code> в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер).


== См. также ==
{{шаблоны для документирования}}
* {{t|таблица примеров}} — рисует таблицу с примерами


<includeonly>
<includeonly>
[[Категория:Шаблоны:Для документирования шаблонов]]
[[Категория:Шаблоны:Для документирования шаблонов]]
</includeonly>
</includeonly>

Текущая версия от 16:18, 12 февраля 2022

Вызывает шаблон {{пример}} для каждого набора параметров, результаты вызовов предваряя маркером списка.

Параметры в этих наборах разделяются через \, сами наборы — через |. Название шаблона берётся из названия текущей страницы (до первого слэша), но его можно указать явно в параметре |t= (|template=).

Доступны многие параметры, используемые в шаблоне {{пример}}, но без знака подчёркивания: |style=, |sep=, |nobr=, |spaced=, |nocat=, |prefix=, |postfix=. Внутри индивидуальных примеров — \_alias=, \_prefix=, \_postfix=, а также \_comment=, \_after= и \_before= для комментария к примеру (но будьте внимательны со знаками равенства, см. ниже). Символ, с которого начинается строка, задаётся в параметре |opener= (по умолчанию — *). Тептар-текст для вставки между примерами — в параметре |between= (например, {{^}}; по умолчанию — пустая строка; за исключением случая |style=*pre: тогда используется значение {{^|3em}}).

Также может использоваться с подстановкой.

Примеры[править код]

{{стопка примеров|t=число|1234|1234567890|1234567\км}}

  • {{число|1234}}1234
  • {{число|1234567890}}1 234 567 890
  • {{число|1234567|км}}1 234 567 км

Для читаемости кода можно располагать каждый набор параметров на своей строке:

{{стопка примеров|t=число
|1234
|1234567890
|1234567\км\_comment{{=}}(Все пробелы — неразрывные.)
}}

  • {{число|1234}}1234  
  • {{число|1234567890}}1 234 567 890  
  • {{число|1234567|км}}1 234 567 км  (Все пробелы — неразрывные.)

В отличие от {{пример}}, {{tc}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте {{=}}. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте &#95; вместо него. Если в примерах используется много именованных параметров, удобно использовать N= в начале строк для номеров параметров, например:

{{стопка примеров|t=[[t:join|join]]|style=wikitable|spaced=1
|1=1=abc = "foobar"; \2=def = "blah-blah-blah"; \3=jhi = "tram-pa-pam"; \separator=<br>
|2=1=abc = "foobar"; \2= \3=def = "blah-blah-blah"; \separator=<br>
}}

Код Результат
{{join |1=abc = "foobar"; |2=def = "blah-blah-blah"; |3=jhi = "tram-pa-pam"; |separator=<br> }} abc = "foobar";
def = "blah-blah-blah";
jhi = "tram-pa-pam";
{{join |1=abc = "foobar"; |2= |3=def = "blah-blah-blah"; |separator=<br> }} abc = "foobar";
def = "blah-blah-blah";

По умолчанию у неименованных параметров (разделённых через |) обрезаются пробелы и переносы строки слева и справа. Чтобы отменить это поведение, используйте |trim=0. Однако, если вы использовали N= в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер).