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

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


Параметры в этих наборах разделяются через <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>\_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}}).
Доступны многие параметры, используемые в шаблоне {{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\км}}
{{Tpre|стопка примеров|t{{=}}[[t:число|число]]|1234|1234567890|1234567\км}}
: {{sp↓|||1em}}
: {{Sp-down|||1em}}
{{стопка примеров|t=число|1234|1234567890|1234567\км}}{{^}}
{{Стопка примеров|t=число|1234|1234567890|1234567\км}}{{^}}


Для читаемости кода можно располагать каждый набор параметров на своей строке:
Для читаемости кода можно располагать каждый набор параметров на своей строке:
<pre>
<pre>
{{стопка примеров|t=число
{{Стопка примеров|t=число
|1234
|1234
|1234567890
|1234567890
Строка 22: Строка 22:
}}
}}
</pre>
</pre>
: {{sp↓|||1em}}
: {{Sp-down|||1em}}
{{стопка примеров|t=число
{{Стопка примеров|t=число
|1234
|1234
|1234567890
|1234567890
Строка 29: Строка 29:
}}{{^}}
}}{{^}}


В отличие от {{t|пример}}, {{t|tc}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте {{tlc|=}}. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте <code>&amp;#95;</code> вместо него. Если в примерах используется много именованных параметров, удобно использовать <code>''N''=</code> в начале строк для номеров параметров, например:
В отличие от {{T|Пример}}, {{T|Tc}} и некоторых других шаблонов, знаки равенства напрямую не работают, используйте {{Tlc|=}}. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте <code>&amp;#95;</code> вместо него. Если в примерах используется много именованных параметров, удобно использовать <code>''N''=</code> в начале строк для номеров параметров, например:
<pre><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>
}}</nowiki>
}}</nowiki>
</pre>
</pre>
{{sp↓}}
{{Sp-down}}
{{стопка примеров|t=join|style=wikitable|spaced=1
{{Стопка примеров|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>) обрезаются пробелы и переносы строки слева и справа. Чтобы отменить это поведение, используйте {{para|trim|0}}. Однако, если вы использовали <code>''N''=</code> в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер).
По умолчанию у неименованных параметров (разделённых через <code>|</code>) обрезаются пробелы и переносы строки слева и справа. Чтобы отменить это поведение, используйте {{Para|Trim|0}}. Однако, если вы использовали <code>''N''=</code> в начале строки, такие параметры в любом случае будут обрезаться (такое поведение заложено в парсер).


{{шаблоны для документирования}}
{{Шаблоны для документирования}}


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

Версия от 17:18, 13 мая 2023

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

Параметры в этих наборах разделяются через \, сами наборы — через |. Название шаблона берётся из названия текущей страницы (до первого слэша), но его можно указать явно в параметре |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. Также, если в вашем шаблоне используются параметры, имена которых начинаются со знака подчёркивания, используйте &#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> }}
{{join |1=abc = "foobar"; |2= |3=def = "blah-blah-blah"; |separator=<br> }}

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