Шаблон:Стопка примеров/doc: различия между версиями
Andras (обсуждение | вклад) (Новая страница: «{{docpage}} {{onLua|ExampleList}} Вызывает шаблон {{t|пример}} для каждого набора параметров, результаты вызовов предваряя маркером списка. Параметры в этих наборах разделяются через <code>\</code>, сами наборы — через <code>|</code>. Название шаблона берётся из названия текущей с...») |
Andras (обсуждение | вклад) Нет описания правки |
||
Строка 1: | Строка 1: | ||
{{ | {{Docpage}} | ||
{{ | {{OnLua|ExampleList}} | ||
Вызывает шаблон {{ | Вызывает шаблон {{T|Пример}} для каждого набора параметров, результаты вызовов предваряя маркером списка. | ||
Параметры в этих наборах разделяются через <code>\</code>, сами наборы — через <code>|</code>. Название шаблона берётся из названия текущей страницы (до первого слэша), но его можно указать явно в параметре {{ | Параметры в этих наборах разделяются через <code>\</code>, сами наборы — через <code>|</code>. Название шаблона берётся из названия текущей страницы (до первого слэша), но его можно указать явно в параметре {{Para|T}} ({{Para|Template}}). | ||
Доступны многие параметры, используемые в шаблоне {{ | Доступны многие параметры, используемые в шаблоне {{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}}). | ||
Также может использоваться с подстановкой. | Также может использоваться с подстановкой. | ||
== Примеры == | == Примеры == | ||
{{ | {{Tpre|стопка примеров|t{{=}}[[t:число|число]]|1234|1234567890|1234567\км}} | ||
: {{ | : {{Sp-down|||1em}} | ||
{{ | {{Стопка примеров|t=число|1234|1234567890|1234567\км}}{{^}} | ||
Для читаемости кода можно располагать каждый набор параметров на своей строке: | Для читаемости кода можно располагать каждый набор параметров на своей строке: | ||
<pre> | <pre> | ||
{{ | {{Стопка примеров|t=число | ||
|1234 | |1234 | ||
|1234567890 | |1234567890 | ||
Строка 22: | Строка 22: | ||
}} | }} | ||
</pre> | </pre> | ||
: {{ | : {{Sp-down|||1em}} | ||
{{ | {{Стопка примеров|t=число | ||
|1234 | |1234 | ||
|1234567890 | |1234567890 | ||
Строка 29: | Строка 29: | ||
}}{{^}} | }}{{^}} | ||
В отличие от {{ | В отличие от {{T|Пример}}, {{T|Tc}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте {{Tlc|=}}. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте <code>&#95;</code> вместо него. Если в примерах используется много именованных параметров, удобно использовать <code>''N''=</code> в начале строк для номеров параметров, например: | ||
<pre><nowiki>{{ | <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> | ||
}}</nowiki> | }}</nowiki> | ||
</pre> | </pre> | ||
{{ | {{Sp-down}} | ||
{{ | {{Стопка примеров|t=join|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> | ||
}}{{^}} | }}{{^}} | ||
По умолчанию у неименованных параметров (разделённых через <code>|</code>) обрезаются пробелы и переносы строки слева и справа. Чтобы отменить это поведение, используйте {{ | По умолчанию у неименованных параметров (разделённых через <code>|</code>) обрезаются пробелы и переносы строки слева и справа. Чтобы отменить это поведение, используйте {{Para|Trim|0}}. Однако, если вы использовали <code>''N''=</code> в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер). | ||
{{ | {{Шаблоны для документирования}} | ||
<includeonly> | <includeonly> | ||
[[Категория:Шаблоны:Для документирования шаблонов]] | [[Категория:Шаблоны:Для документирования шаблонов]] | ||
</includeonly> | </includeonly> |
Версия от 17:18, 13 мая 2023
![]() |
![]() | Этот шаблон реализован на основе 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}}
→{{число|1234567890}}
→{{число|1234567|км}}
→
Для читаемости кода можно располагать каждый набор параметров на своей строке:
{{Стопка примеров|t=число |1234 |1234567890 |1234567\км\_comment{{=}}(Все пробелы — неразрывные.) }}
- ↓
{{число|1234}}
→{{число|1234567890}}
→{{число|1234567|км}}
→ (Все пробелы — неразрывные.)
В отличие от {{Пример}}, {{Tc}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте Шаблон:Tlc. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте _
вместо него. Если в примерах используется много именованных параметров, удобно использовать 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> }} | |
{{join |1=abc = "foobar"; |2= |3=def = "blah-blah-blah"; |separator=<br> }} |
По умолчанию у неименованных параметров (разделённых через |
) обрезаются пробелы и переносы строки слева и справа. Чтобы отменить это поведение, используйте |Trim = 0
. Однако, если вы использовали N=
в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер).