Шаблон:Docparam: различия между версиями

м (Замена текста — «\[\[en:.*» на «»)
 
Нет описания правки
 
(не показаны 2 промежуточные версии этого же участника)
Строка 2: Строка 2:


--><div class="va-docparam"><!--
--><div class="va-docparam"><!--
  --><div class="va-docparam-icon">{{#switch:{{{req}}}|no={{icon|optional}}|semi={{icon|semi-required}}|yes|#default={{icon|required}}}}</div><!--
  --><div class="va-docparam-icon">{{#switch:{{{req}}}|no={{Иконка|optional}}|semi={{Иконка|semi-required}}|yes|#default={{Иконка|required}}}}</div><!--
  -->{{#if:{{{default|}}}|<div class="va-docparam-default">(по умолчанию: {{#switch:{{lc:{{{default}}}}}|none|-=none|#default="{{{default}}}"}}{{#if:{{{default2|}}}|&#032;or {{#switch:{{lc:{{{default2}}}}}|none|-=none|#default="{{{default2}}}"}}}})</div>}}<!--
  -->{{#if:{{{default|}}}|<div class="va-docparam-default">(по умолчанию: {{#switch:{{lc:{{{default}}}}}|none|-=none|#default="{{{default}}}"}}{{#if:{{{default2|}}}|&#032;or {{#switch:{{lc:{{{default2}}}}}|none|-=none|#default="{{{default2}}}"}}}})</div>}}<!--
  --><span class="va-docparam-params">'''{{#if:{{{name|{{{1|}}}}}}|{{#replace:{{#replace:{{#replace:{{#replace:{{{name|{{{1|}}}}}}||&#032;}}|&#032;>>&#032;|''' вплоть до '''}}|&#032;//&#032;|''' или '''}}|&#032;++&#032;|''', '''}}|Name?}}</span>'''<!--
  --><span class="va-docparam-params">'''{{#if:{{{name|{{{1|}}}}}}|{{#replace:{{#replace:{{#replace:{{#replace:{{{name|{{{1|}}}}}}||&#032;}}|&#032;>>&#032;|''' вплоть до '''}}|&#032;//&#032;|''' или '''}}|&#032;++&#032;|''', '''}}|Name?}}</span>'''<!--
Строка 12: Строка 12:


--></onlyinclude>
--></onlyinclude>
<noinclude>{{Doc}}
<noinclude>{{documentation}}
[[Категория:Служебные шаблоны]]
Template:Docparam]]
Template:Docparam]]
</noinclude>
</noinclude>

Текущая версия от 16:56, 20 марта 2023

required
Name?
Description?

Шаблон для стардантизации форматируемых параметров шаблона из страниц категории документация шаблонов.

Использование

{{Docparam|name=параметр|req=yes|desc=описание}}

Параметры

required
безымяный1 или name
Название параметра(ов). Еслиии параметров несколько, они указываются через специальные управляющие комбинации символов.

Управляющие комбинации (для распознавания должны быть окружены пробелами):

  • >> преобразуется во фразу «вплоть до»; используется для указания ряда (например, «игра1 вплоть до игра5»).
  • // преобразуется в «или», используется для альтернативных вариантов (например, «безымянный1 или название»).
  • ++ преобразуется в запятую с пробелом («, »), используется для включения в список параметров с другим именем, но схожим функционалом (например, «contentA1, contentB1»).
optional
default, default2
Значение(я) параметра по умолчанию.
required
desc
Описание параметра.
semi-required
(по умолчанию: "yes")
req
Указывает, является ли этот параметр необходимым для корректной работы шаблона.

Доступные опции:

  • no: Необязателен.
  • semi: Требуется при определенных обстоятельствах, но при других нет. Для ряда параметров (заданного через >>) это означает, что по крайней мере один из них требуется.
  • yes: Всегда требуется.

Копировать/вставить

{{Docparam|name=|req=|default=|desc=

}}

Пример

Простой

{{Docparam|name=параметр|req=yes|default=|desc=
Описание
}}

результат:

required
параметр
Описание

Продвинутый

{{Docparam|name=параметр // альтернатива ++ аналогичный1 >> аналогичный3|req=no|default=default setting|desc=
Описание
}}

результат:

optional
(по умолчанию: "default setting")
параметр или альтернатива, аналогичный1 вплоть до аналогичный3
Описание

Template:Docparam]]