Шаблон:Стопка примеров/doc: различия между версиями
Mansur700 (обсуждение | вклад) (Новая страница: «{{docpage}} {{onLua|ExampleList}} Вызывает шаблон {{t|пример}} для каждого набора параметров, результаты...») |
Adam (обсуждение | вклад) Нет описания правки |
||
Строка 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> | Доступны многие параметры, используемые в шаблоне {{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>&#95;</code> вместо него. Если в примерах используется много именованных параметров, удобно использовать <code>''N''=</code> в начале строк для номеров параметров, например: | В отличие от {{t|пример}}, {{t|tc}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте {{tlc|=}}. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте <code>&#95;</code> вместо него. Если в примерах используется много именованных параметров, удобно использовать <code>''N''=</code> в начале строк для номеров параметров, например: | ||
<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> в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер). | ||
{{шаблоны для документирования}} | |||
<includeonly> | <includeonly> | ||
[[Категория:Шаблоны:Для документирования шаблонов]] | [[Категория:Шаблоны:Для документирования шаблонов]] | ||
</includeonly> | </includeonly> |
Текущая версия от 15:18, 12 февраля 2022
Этот шаблон реализован на основе Lua с использованием модуля ExampleList. |
Вызывает шаблон {{пример}} для каждого набора параметров, результаты вызовов предваряя маркером списка.
Параметры в этих наборах разделяются через \
, сами наборы — через |
. Название шаблона берётся из названия текущей страницы (до первого слэша), но его можно указать явно в параметре |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}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте {{=}}
. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте _
вместо него. Если в примерах используется много именованных параметров, удобно использовать 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=
в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер).