Majestix: 1 revision imported: Initial Setup

2026-04-12T07:51:36Z

1 revision imported: Initial Setup

← Older revision		Revision as of 09:51, 12 April 2026
(No difference)

en>HyperNervie at 15:55, 24 November 2025

2025-11-24T15:55:31Z

New page

{{Documentation subpage}}
{{Lua|Module:ListToText}}
{{Template shortcut|ltt}}

== Usage ==

This template concatenates a sequence of items with separators in page language. When there are at least two items, the last two items are instead joined with a conjunction word in page language.

This is useful in translateable pages: if the items are not to be translated, rather than making each item a <tvar>, it's better to list the items with this template and make the whole transclusion a <tvar>.

== Parameters ==

* (Unnamed arguments): The items.
* {{param|sep}}: The separator. By default it's <code>{{((}}[[Template:Int|int]]|comma-separator}}</code>. (In your interface language it's <code>{{int:comma-separator}}</code>.)
* {{param|conj}}: The conjunction word. By default it's <code>{{((}}[[Template:Int|int]]|and}}{{((}}[[Template:Int|int]]|word-separator}}</code>. (In your interface language it's <code>{{int:and}}{{int:word-separator}}</code>.)
* {{param|noconj}}: If true (see [[Module:Yesno]] to learn what is considered as true), still use the separator to join the last two items.
* {{param|fmt}}: An optional format string with "$1" substring. If given, each item is converted to this string with "$1" replaced with the item. HTML tags are supported. Templates, magic words and extension tags ''can'' be parsed but you need to escape them in proper ways. See below to learn more.

(TemplateData to be added)

== Examples ==

* A transclusion with no items given yields nothing: <code>{{((}}ltt}}</code> → {{ltt}}
* One item: <code>{{((}}ltt|1}}</code> → {{ltt|1}}
* Two items: <code>{{((}}ltt|1|2}}</code> → {{ltt|1|2}}
* Even more items: <code>{{((}}ltt|1|2|3|4}}</code> → {{ltt|1|2|3|4}}
* Different separator & no conjunction word: <code>{{((}}ltt|sep=&nbsp;{{((}}!}}&nbsp;|noconj=1|1|2|3|4}}</code> → {{ltt|sep= {{!}} |noconj=1|1|2|3|4}}
* Format string: <code>{{((}}ltt|fmt=($1)|1|2|3|4}}</code> → {{ltt|fmt=($1)|1|2|3|4}}

== Use of format string ==

HTML tags can be directly used in the format string. They can be rendered correctly.

* <code>{{((}}ltt|fmt=<code>$1</code>|1|2|3|4}}</code> → {{ltt|fmt=<code>$1</code>|1|2|3|4}}

However, templates and magic words need escaping with {{tl|((}} and {{tl|))}}, and extension tags with {{tl|^(}} and {{tl|)^}}, or they will be parsed before being passed to the [[Module:ListToText|underlying module]]. Don't use <code><nowiki></nowiki></code> or character entities; things may otherwise end up as plain text.

* <code>{{((}}ltt|fmt={{((}}((}}[[Template:Tl|tl]]{{((}}!}}$1{{((}}))}}|((|))|^(|)^}}</code> → {{ltt|fmt={{((}}tl{{!}}$1{{))}}|((|))|^(|)^}}
* <code>{{((}}ltt|fmt={{((}}((}}{{ll|Help:Magic words#Namespaces|NAMESPACE}}:$1{{((}}))}}|Help:A|Project:B|Template:C}}</code> → {{ltt|fmt={{((}}NAMESPACE:$1{{))}}|Help:A|Project:B|Template:C}}
* <code>{{((}}ltt|fmt={{((}}^(}}{{ll|Extension:SyntaxHighlight|syntaxhighlight}} inline lang="lua">local $1</syntaxhighlight>|a|b|c}}</code> → {{ltt|fmt={{^(}}syntaxhighlight inline lang="lua">local $1</syntaxhighlight>|a|b|c}}

== In translateable pages ==
If all arguments are not to be translated, you can wrap the whole transclusion with <tvar> like: <code><tvar name="1">{{((}}ltt|noconj=yes|1|2|3|4}}</tvar></code>.

If some arguments are to be translated, wrap the template name and not-to-be-translated arguments with <tvar> and leave other things outside, like: <code>{{((}}<tvar name="1">ltt|don't|translate|that</tvar>|translate|this}}</code> (Translators will see <code>{{((}}$1|translate|this}}</code>). Note that if you're using custom separators and conjunction words, they might need to be localized and you need to expose them outside the <tvar> tag.
<includeonly>{{Sandbox other||

[[Category:Inline templates{{#translation:}}]]
}}</includeonly>

Template:ListToText/doc - Revision history

Majestix: 1 revision imported: Initial Setup

en>HyperNervie at 15:55, 24 November 2025