Шаблон:Стопка примеров/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= в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер).