Модул:Transclude/doc
This is the documentation page for Модул:Transclude
Диққат! Ин яке аз модулҳоест, ки аз ҳама бештар истифода мешаванд. |
Этот модуль относится к критическим. У него очень много включений или он используется с подстановкой. Из-за опасности вандализма или ошибочного редактирования он был защищён. |
Тобеъҳо
[вироиши манбаъ]uni
[вироиши манбаъ]{{#invoke:Transclude|uni|номи шаблон|феҳристи параметрҳо…}}
Унифицирует обращение к шаблону, преобразует все имена параметров к нижнему регистру и позволяет задавать удобные псевдонимы (вводить параметрами в нижнем регистре).
forall
[вироиши манбаъ]{{#invoke:Transclude|forall|имя шаблона}}
Вызывает заданный шаблон, передавая ему нумерованные параметры по-одному: сначала {{имя шаблона|1={{{1|}}}}}
, потом {{имя шаблона|1={{{2|}}}}}
, {{имя шаблона|1={{{3|}}}}}
и т. д.
Предполагается, что параметры введены подряд, при пропуске поведение не определено (TODO).
escapeparams
[вироиши манбаъ]{{#invoke:Transclude|escapeparams|(зарезервировано автором?) |разделитель пар|альтернатива знаку равенства |суффикс}}
Возвращает параметры (вызывающего шаблона? --Incnis Mrsi) через «|» с заменой «=» на «{{=}}» и «|» на «{{!}}». Параметры предусмотрены, но необязательны.
Предполагается когда-то снабдить интеллектом для незамены палочек в вики-ссылках и сортировки.
Назначение параметров f.args[2], f.args[3] и f.args[4] угадано участником Incnis Mrsi и может не соответствовать замыслу автора, исходная документация на них отсутствовала.
npc
[вироиши манбаъ]{{#invoke:Transclude|npc|имя шаблона 1[|имя шаблона 2…] |базовое имя[=значение]|…}}
Абзац сильно переписан, т.к. авторский текст был тотально невразумителен. --Incnis Mrsi
- Итератор по массиву из групп параметров типа «параметрk=…» (где номер k группы — десятичное число) вызываемого шаблона. Группы подставляются в список из одного или более указанных шаблонов, заданных в виде нумерованных параметров. Одна группа в один из шаблонов, которые применяются по круговой очереди с возрастанием k. Вывод шаблонов соединяется в том же порядке. Пример использования с двумя шаблонами: полосатые строки в таблицах.
Именованные параметры представляют базовые имена вызывающего шаблона (автор хотел сказать, его параметров? --Incnis Mrsi), которые будут также именами параметров для вызываемых шаблонов. Их значения (необязательные) будут использоваться по умолчанию, если для какого-то k есть некоторые, но не все значения. По-видимому автор намекает на то, что когда для какого-то k нет значений никаких, на нём процесс и останавливается. --Incnis Mrsi
Параметры сортируются при выводе по числам (начиная с ничего, потом ноль).Шаблон:Непонятно видимо, отсылка к оператору table.sort(ns); но смысл ускользает. --Incnis Mrsi
call
[вироиши манбаъ]{{#invoke:Transclude|call|имя шаблона}}
Просто вызывает указанный шаблон с аргументами вызывающего.
join
[вироиши манбаъ]{{#invoke:Transclude|join|разделитель|терминальный разделитель |игнор|[from=номер|][to=номер|]список параметров…}}
Версия #forall без шаблона, объединяет нумерованные аргументы от from
или 1 до to
или первого отсутствующего через указанный разделитель.
Последний элемент можно присоединять иначе, задав терминальный разделитель (необязательный; по умолчанию «,» или «и»).
Если значение параметра игнор равно «s», то строки из пробелов игнорируются; если оно равно «_», то игнорируются пустые строки.
cycle
[вироиши манбаъ]{{#invoke:Transclude|cycle|имя шаблона|n|список параметров…}}
Действует аналогично #forall по числовой переменной, изменяющейся от 1 до n. Другое начало можно задать в виде «-10..10» вместо n, или в обратном порядке «10..-10». Также можно задать предел цикла в виде имени шаблона (если второго параметра нет или он имеет вид «1..», шаблон раскрывается, пока не пуст). Не увлекайтесь!
Замечание: номера нумерованных параметров шаблона при записи увеличить на 1.
Параметром output
можно задать как выводить шаблоны.
- newline — каждый шаблон на новой строке.
- inline — все шаблоны в одну строку (по-умолчанию).
Намунаҳои корбурд
[вироиши манбаъ]- Шаблон:Қуттӣ (барои {{#invoke:Transclude|npc}})
Функции
[вироиши манбаъ]uni
[вироиши манбаъ]{{#invoke:Transclude|uni|имя шаблона|список параметров…}}
Унифицирует обращение к шаблону, преобразует все имена параметров к нижнему регистру и позволяет задавать удобные псевдонимы (вводить параметрами в нижнем регистре).
forall
[вироиши манбаъ]{{#invoke:Transclude|forall|имя шаблона}}
Применяет шаблон ко всем аргументам вызывающего шаблона или их группам, можно задавать доп. опции.
Если после имени шаблона поставить «#», следующая часть параметра будет разделителем, по умолчанию ничего.
escapeparams
[вироиши манбаъ]{{#invoke:Transclude|escapeparams|(зарезервировано автором?) |разделитель пар|альтернатива знаку равенства |суффикс}}
Возвращает параметры (вызывающего шаблона? --Incnis Mrsi) через «|» с заменой «=» на «{{=}}» и «|» на «{{!}}». Параметры предусмотрены, но необязательны.
Предполагается когда-то снабдить интеллектом для незамены палочек в вики-ссылках и сортировки.
Назначение параметров f.args[2], f.args[3] и f.args[4] угадано участником Incnis Mrsi и может не соответствовать замыслу автора, исходная документация на них отсутствовала.
npc
[вироиши манбаъ]{{#invoke:Transclude|npc|имя шаблона 1[|имя шаблона 2…] |базовое имя[=значение]|…}}
Абзац сильно переписан, т.к. авторский текст был тотально невразумителен. --Incnis Mrsi
- Итератор по массиву из групп параметров типа «параметрk=…» (где номер k группы — десятичное число) вызываемого шаблона. Группы подставляются в список из одного или более указанных шаблонов, заданных в виде нумерованных параметров. Одна группа в один из шаблонов, которые применяются по круговой очереди с возрастанием k. Вывод шаблонов соединяется в том же порядке. Пример использования с двумя шаблонами: полосатые строки в таблицах.
Именованные параметры представляют базовые имена вызывающего шаблона (автор хотел сказать, его параметров? --Incnis Mrsi), которые будут также именами параметров для вызываемых шаблонов. Их значения (необязательные) будут использоваться по умолчанию, если для какого-то k есть некоторые, но не все значения. По-видимому автор намекает на то, что когда для какого-то k нет значений никаких, на нём процесс и останавливается. --Incnis Mrsi
Параметры сортируются при выводе по числам (начиная с ничего, потом ноль).Шаблон:Нофаҳмо видимо, отсылка к оператору table.sort(ns); но смысл ускользает. --Incnis Mrsi
call
[вироиши манбаъ]{{#invoke:Transclude|call|имя шаблона}}
Просто вызывает указанный шаблон с аргументами вызывающего.
join
[вироиши манбаъ]{{#invoke:Transclude|join|разделитель|терминальный разделитель |игнор|[from=номер|][to=номер|]список параметров…}}
Версия #forall без шаблона, объединяет нумерованные аргументы от from или 1 до to или первого отсутствующего через указанный разделитель.
Последний элемент можно присоединять иначе, задав терминальный разделитель (необязательный; по умолчанию «,» или «и»).
Если значение параметра игнор равно «s», то строки из пробелов игнорируются; если оно равно «_», то игнорируются пустые строки.
cycle
[вироиши манбаъ]{{#invoke:Transclude|cycle|имя шаблона|n|список параметров…}}
Действует аналогично #forall по числовой переменной, изменяющейся от 1 до n. Другое начало можно задать в виде «-10..10» вместо n. Также можно задать предел цикла в виде имени шаблона (если второго параметра нет или он имеет вид «1..», шаблон раскрывается, пока не пуст). Не увлекитесь!
Замечание: номера нумерованных параметров шаблона при записи увеличить на 1.
Примеры использования
[вироиши манбаъ]- Шаблон:Қуттӣ/Temp (для {{#invoke:Transclude|npc}})