Шаблон:Пример/doc: различия между версиями
(Новая страница: «{{docpage}} {{onLua|Example}} {{rellink|{{днш|example}}}} Этот шаблон выводит вики-текст включения шаблона (в общем случае с параметрами) и само это включение. Он в основном предназначен для упрощения оформления примеров использования шаблонов в документациях. В данный момен...») |
Нет описания правки |
||
Строка 6: | Строка 6: | ||
В данный момент шаблон не может использоваться для оформления примеров шаблонов с многострочным кодом и содержащих шаблоны внутри шаблона. (Хотя это технически реализуемо, см. [[Обсуждение шаблона:Пример#Напутствие шаблонописателям|обсуждение]].) | В данный момент шаблон не может использоваться для оформления примеров шаблонов с многострочным кодом и содержащих шаблоны внутри шаблона. (Хотя это технически реализуемо, см. [[Обсуждение шаблона:Пример#Напутствие шаблонописателям|обсуждение]].) | ||
Для вывода групп примеров пользуйтесь шаблонами | Для вывода групп примеров пользуйтесь шаблонами } (списком) и | ||
{{TOC right}} | {{TOC right}} | ||
== Использование == | == Использование == | ||
* | * | ||
Первый параметр можно опускать — тогда его заменит название базовой страницы со строчной первой буквы. Например, в документации шаблона {{t|tr-en}} <code><nowiki> | Первый параметр можно опускать — тогда его заменит название базовой страницы со строчной первой буквы. Например, в документации шаблона {{t|tr-en}} <code><nowiki></nowiki></code> даст: | ||
: | : | ||
Это может быть особенно удобно для групп шаблонов, для которых пишется общая документация, размещаемая на каждой странице. А {{tc|пример}} выведет пример включения шаблона, на странице которого этот код размещён, без параметров. | Это может быть особенно удобно для групп шаблонов, для которых пишется общая документация, размещаемая на каждой странице. А {{tc|пример}} выведет пример включения шаблона, на странице которого этот код размещён, без параметров. | ||
Для наглядности можно также указывать имя шаблона через параметр '''_template''', при этом первый параметр больше не значит имя шаблона: | Для наглядности можно также указывать имя шаблона через параметр '''_template''', при этом первый параметр больше не значит имя шаблона: | ||
* <code><nowiki> | * <code><nowiki></nowiki></code> даст | ||
== Ограничения и пути их обхода == | == Ограничения и пути их обхода == | ||
При опускании первого параметра используется именно имя корневой страницы — {{mwmw|ROOTPAGENAME}}, а не проверка на суффиксы {{code|/doc}} или иные, так что для шаблонов, которые являются подстраницами других шаблонов (например, [[Special:PrefixIndex/Template:Userbox/|юзербоксов]]), первый параметр опускать нельзя. | При опускании первого параметра используется именно имя корневой страницы — {{mwmw|ROOTPAGENAME}}, а не проверка на суффиксы {{code|/doc}} или иные, так что для шаблонов, которые являются подстраницами других шаблонов (например, [[Special:PrefixIndex/Template:Userbox/|юзербоксов]]), первый параметр опускать нельзя. | ||
Строка 29: | Строка 23: | ||
Модуль переносит все именованные параметры в конец, а также плохо сохраняет порядок следования именованных параметров, если их больше одного (из-за технического несовершенства ПО). Чтобы этого избежать, используйте {{tcl|=}} вместо <code>=</code>: | Модуль переносит все именованные параметры в конец, а также плохо сохраняет порядок следования именованных параметров, если их больше одного (из-за технического несовершенства ПО). Чтобы этого избежать, используйте {{tcl|=}} вместо <code>=</code>: | ||
{| | {| | ||
| valign=top | [[Файл:Red x.svg|15px]] || <code><nowiki> | | valign=top | [[Файл:Red x.svg|15px]] || <code><nowiki>></code> даст:<br | ||
/> | |/> | ||
| valign=top | [[Файл:Yes_check.svg|15px]] || <code><nowiki> | |||
| valign=top | [[Файл:Yes_check.svg|15px]] || <code><nowiki> | /> | ||
/> | |||
|} | |} | ||
Также нельзя записывать напрямую параметры, чьи имена начинаются со знака подчёркивания, — для предотвращения пересечения с параметрами, модифицирующими внешний вид результата. Поможет то же решение: | Также нельзя записывать напрямую параметры, чьи имена начинаются со знака подчёркивания, — для предотвращения пересечения с параметрами, модифицирующими внешний вид результата. Поможет то же решение: | ||
* <code><nowiki> | * <code><nowiki></nowiki></code> даст | ||
Чтобы вписать {{tago|nowiki}}, используйте HTML-сущности для замены угловых скобок, например: | Чтобы вписать {{tago|nowiki}}, используйте HTML-сущности для замены угловых скобок, например: | ||
* <code><nowiki> | * <code><nowiki>}</nowiki></code> даст </nowiki></nowiki>}} | ||
Чтобы вписать {{tc|=}}, используйте <code><nowiki>{{((}}{{=}}{{))}}</nowiki></code> или HTML-сущности, например: | Чтобы вписать {{tc|=}}, используйте <code><nowiki>{{((}}{{=}}{{))}}</nowiki></code> или HTML-сущности, например: | ||
* <code><nowiki> | * <code><nowiki>></code> даст | ||
<dl><dd> | <dl><dd>}</dd></dl> | ||
В данный момент не поддерживается раскрытие вложенных шаблонов и других конструкций с фигурными скобками (их можно указывать внутри {{tago|nowiki}}, но они не раскроются). Многострочные шаблоны также не поддерживаются. | В данный момент не поддерживается раскрытие вложенных шаблонов и других конструкций с фигурными скобками (их можно указывать внутри {{tago|nowiki}}, но они не раскроются). Многострочные шаблоны также не поддерживаются. | ||
Строка 50: | Строка 43: | ||
== Настройки == | == Настройки == | ||
* '''_sep''': поменять стрелочку на что угодно другое: | * '''_sep''': поменять стрелочку на что угодно другое: | ||
*: <code><nowiki> | *: <code><nowiki>}</nowiki></code> даст | ||
* '''_tag''': поменять обёртку <code>: | * '''_tag''': поменять обёртку <code>: | ||
*: <code><nowiki> | *: <code><nowiki>/code> даст | ||
* '''_link''': включить отображение ссылки: | * '''_link''': включить отображение ссылки: | ||
*: <code>< | *: <code><nowiki></code> даст | ||
* '''_pre-text''' ('''_prefix''') и '''_post-text''' ('''_postfix'''): указать текст до и после шаблона: | * '''_pre-text''' ('''_prefix''') и '''_post-text''' ('''_postfix'''): указать текст до и после шаблона: | ||
*: <code>< | *: <code><nowiki></code> даст | ||
* '''_nobr''': запретить перенос строки для кода примера. | * '''_nobr''': запретить перенос строки для кода примера. | ||
* '''_nocat''': запретить добавлять страницу в проставляемые шаблоном категории, если у него предусмотрен соответствующий параметр <code>_nocat</code>. При этом в коде включения шаблона этот параметр отображаться не будет. Так, например, в данном примере настоящая страница не добавляется в категорию {{cl|Компании, имеющие листинг акций на NASDAQ}}: | * '''_nocat''': запретить добавлять страницу в проставляемые шаблоном категории, если у него предусмотрен соответствующий параметр <code>_nocat</code>. При этом в коде включения шаблона этот параметр отображаться не будет. Так, например, в данном примере настоящая страница не добавляется в категорию {{cl|Компании, имеющие листинг акций на NASDAQ}}: | ||
*: <code><nowiki> | *: <code><nowiki> | ||
* '''_spaced''': отбить пробелом каждый параметр для лучшей читаемости: | * '''_spaced''': отбить пробелом каждый параметр для лучшей читаемости: | ||
*: <code><nowiki>{ | *: <code><nowiki>{</code> даст: | ||
*: | *: | ||
* '''_comment''': снабдить пример комментарием: | * '''_comment''': снабдить пример комментарием: | ||
*: <code><nowiki> | *: <code><nowiki>}</nowiki></code> даст | ||
=== Стили === | === Стили === | ||
С помощью параметра '''_style''' можно установить стиль, который будет устанавливать некоторые из вышеперечисленных параметров разом. Существующие на данный момент стили — <code>pre</code>, <code>*pre</code> и <code>wikitable</code> (а также <code>pre↓</code>): | С помощью параметра '''_style''' можно установить стиль, который будет устанавливать некоторые из вышеперечисленных параметров разом. Существующие на данный момент стили — <code>pre</code>, <code>*pre</code> и <code>wikitable</code> (а также <code>pre↓</code>): | ||
* <code><nowiki> | * <code><nowiki>1 января 2010|_style=pre}}</nowiki></code> даст: | ||
: | : 1 января 2010|_style=pre}}{{^}} | ||
* <code><nowiki> | * <code><nowiki>}1 января 2010|_style=*pre}}</nowiki></code> даст: | ||
: | : 1 января 2010|_style=*pre}} | ||
{{*pre|<nowiki>{| class="wikitable" | {{*pre|<nowiki>{| class="wikitable" | ||
! Код !! Результат | ! Код !! Результат | ||
|- | |- | ||
| { | | { | ||
|- | |- | ||
| | | | ||
... | ... | ||
|}</nowiki>}} | |}</nowiki>}} | ||
Строка 86: | Строка 78: | ||
! Код !! Результат | ! Код !! Результат | ||
|- | |- | ||
| | | | ||
|- | |- | ||
| | | | ||
|- | |- | ||
| colspan=2 | … | | colspan=2 | … |
Версия от 17:56, 5 декабря 2022
Этот шаблон выводит вики-текст включения шаблона (в общем случае с параметрами) и само это включение. Он в основном предназначен для упрощения оформления примеров использования шаблонов в документациях.
В данный момент шаблон не может использоваться для оформления примеров шаблонов с многострочным кодом и содержащих шаблоны внутри шаблона. (Хотя это технически реализуемо, см. обсуждение.)
Для вывода групп примеров пользуйтесь шаблонами } (списком) и
Использование
Первый параметр можно опускать — тогда его заменит название базовой страницы со строчной первой буквы. Например, в документации шаблона {{tr-en}} даст:
Это может быть особенно удобно для групп шаблонов, для которых пишется общая документация, размещаемая на каждой странице. А {{пример}}
выведет пример включения шаблона, на странице которого этот код размещён, без параметров.
Для наглядности можно также указывать имя шаблона через параметр _template, при этом первый параметр больше не значит имя шаблона:
даст
Ограничения и пути их обхода
При опускании первого параметра используется именно имя корневой страницы — {{ROOTPAGENAME}}, а не проверка на суффиксы /doc
или иные, так что для шаблонов, которые являются подстраницами других шаблонов (например, юзербоксов), первый параметр опускать нельзя.
Модуль переносит все именованные параметры в конец, а также плохо сохраняет порядок следования именованных параметров, если их больше одного (из-за технического несовершенства ПО). Чтобы этого избежать, используйте {{=}}
вместо =
:
></code> даст:<br
|/>
| valign=top | [[Файл:Yes_check.svg|15px]] || <code><nowiki>
/>
|}
Также нельзя записывать напрямую параметры, чьи имена начинаются со знака подчёркивания, — для предотвращения пересечения с параметрами, модифицирующими внешний вид результата. Поможет то же решение:
* <code><nowiki> даст
Чтобы вписать
Чтобы вписать
СтилиС помощью параметра _style можно установить стиль, который будет устанавливать некоторые из вышеперечисленных параметров разом. Существующие на данный момент стили —
См. также
|