Nhwɛdo:Template link with subst

{{subst:Nhwɛdo:Template link with subst}}

Template documentation[view] [edit] [history] [purge]

This template, often abbreviated as {{tls}}, is used to provide stylized formatting to template displays without actually using the template itself. The code generated will be displayed inline. For a multi-line output, see {{tj}}.

Parameters

With the exception of alttext, the named parameters are toggles that are either omitted (default in most cases) or activated (by being assigned a value such as "on", "yes", "true", "include", etc.). They may be included in any order (see Examples below). Certain templates have the parameter "on" by default; see the main table for all alternate options. If a row renders identically to a previous row, it means the current template does not support that option and {{tlg}} needs to be used instead.

Parameter	Action	Use with {{example}}	Default active
	Default (without accessory parameters)	{{subst:example}}
brace	Include braces as part of the template link	{{subst:example}}	{{tlw}}/{{tn}}
braceinside	Include innermost braces as part of the template link	{{subst:example}}
bold	Renders the template link/name in bold	{{subst:example}}	{{tlb}}, {{tlxb}}
code	Display output using HTML <code>...</code> tags (monospaced font)	{{subst:example}}	{{tlc}}, {{Template link expanded}}, etc.
italic	Display any parameters accompanying the template link/name in italics	{{subst:example|param}}	{{tlxi}}
kbd	Display output using HTML <kbd>...</kbd> tags (monospaced font)	{{subst:example}}
nolink	Don't render the template name as a link	{{subst:example}}	{{tlf}}, {{tnull}}
nowrap	Prevent the insertion of line breaks (word wrap) in the output	{{subst:example}}	{{tlp}}
nowrapname	Prevent word wrapping in the output of template name/link (parameters will wrap if needed)	{{subst:example}}
plaincode	Uses <code style="border:none; background:transparent;">...</code>	{{subst:example}}	{{tltss}}
subst	Include a subst: prefix before the template link/name	{{subst:example}}	{{tls}}, {{tlxs}}, etc
alttext=[text]	Replace [text] with the actual label to be displayed for the template link	{{subst:Other}}	{{tla}}
_show_result	Will also display the result of the template	{{subst:Min|7|-5}} → -5
_expand	Will add a link to the expanded template page	{{subst:Min|7|-5}} [1]
a	will add an asterisk before the template code	* {{subst:Min|7|-5}}

Unnamed (Positional)

This template can take any number of unnamed parameters as parameters accompanying the template link (or name); see Examples below.

Examples

Code	Output	Remarks
{{tls|Banner}}	{{subst:Banner}}	Template:Banner does not exist. (Non-existent template is redlinked.)
{{tls|Abc}}	{{subst:Abc}}	Template:Abc exists.
{{tls|abC}}	{{subst:abC}}	Template names are case-sensitive
{{tls|abc}}	{{subst:abc}}	(but the first letter is case-insensitive).
{{tls|x0}}	{{subst:x0}}	no parameters
{{tls|x1|one}}	{{subst:x1|one}}	one parameter
{{tls|x2|one|two}}	{{subst:x2|one|two}}	two parameters
{{tls|x3|1|2|3|4|5|6|7|8|9|10}}	{{subst:x3|1|2|3|4|5|6|7|8|9|10}}	ten parameters
{{tls|convert|14|m|ftin|abbr=out|sp=us}}	{{subst:convert|14|m|ftin|abbr=out|sp=us}}	Unlimited parameters, as one <nowiki>...</nowiki> string.
{{tls|x2||two||}}	{{subst:x2|two}}	Empty parameters are discarded.
{{tls|x0|code=on}}	{{subst:x0}}	<code> style
{{tls|x0|plaincode=on}}	{{subst:x0}}	plaincode style
{{tls|x0|kbd=on}}	{{subst:x0}}	<kbd> style
{{tls|x0|bold=on}}	{{subst:x0}}	bold link/name
{{tls|x1|one|italic=on}}	{{subst:x1|one}}	parameter(s) in italics
{{tls|x0|nolink=on}}	{{subst:x0}}
{{tls|x0|subst=on}}	{{subst:x0}}
{{tls|x0|brace=on}}	{{subst:x0}}	all braces in link
{{tls|x0|braceinside=on}}	{{subst:x0}}	inside braces in link
{{tls|x0|alttext=x0 link}}	{{subst:x0 link}}
{{tls|x0|bold=on|code=on|brace=on}}	{{subst:x0}}	Combine multiple parameter settings.
{{tls|abc|{{spaces}}one{{spaces}}}}	{{subst:abc| one }}	Using {{spaces}} before and after a parameter.
{{tls|x2|bold=on|code=on|one|two}}	{{subst:x2|one|two}}	Can combine named and anonymous parameters ...
{{tls|x2|one|two|bold=on|code=on}}	{{subst:x2|one|two}}	... in any order ...
{{tls|x2|one|code=on|two|bold=on|three}}	{{subst:x2|one|two|three}}	... even intermixed ...
{{tls|x2|one|code=on|two|bold=on|three|italic=on}}	{{subst:x2|one|two|three}}	... with many configurations.
{{tls|x1}}	{{subst:x1}}	= won't work
{{tls|x1|x=u}}	{{subst:x1|x=u}}	&#61; is okay
{{tls|x1|x=u}}	{{subst:x1|x=u}}	{{=}} is okay (see Template:=)
{{tls|x1|x=u}}	{{subst:x1|x=u}}	Sticky nowiki is okay.
{{tls|x2|3=two|2=one}}	{{subst:x2|one|two}}	Right-to-left is okay
{{tls}}	tls	With no arguments, it emits the current page name without braces.
{{tls|x2|3=one|4=two}}	{{subst:x2}}	Null parameter stops parsing.

Wrapping of long names (default)

Code	Output
{{tls|long template name that would wrap to new line|this is a long value for the 1st parameter that would wrap}}	{{subst:long template name that would wrap to new line|this is a long value for the 1st parameter that would wrap}}

Wrapping of long names (nowrap=on)

Code	Output
{{tls|nowrap=on|long template name that would wrap to new line|long value for the 1st parameter that would wrap}}	{{subst:long template name that would wrap to new line|long value for the 1st parameter that would wrap}}

Wrapping of long names (nowrapname=on)

Code	Output
{{tls|nowrapname=on|long template name that would wrap to new line|long value for the 1st parameter that would wrap}}	{{subst:long template name that would wrap to new line|long value for the 1st parameter that would wrap}}

See also

General-purpose formatting

Comparison of template-linking templates according to the styles of generated text and link produced

Text style ↓	{{tlg}} options to achieve text style	Link style
		Linked	Unlinked	Linked with subst	Unlinked with subst	Linked including braces	Linked with alternative text
{{tlg}} options to achieve link style	—	DEFAULT	nolink=yes	subst=yes	nolink=yes|subst=yes	braceinside=yes	alttext=Foo 2=Foo
normal	DEFAULT	{{tlg}} {{tl}} {{tlp|1|2|...}} {{Template:tlu}}	{{tlf}} <template link>	{{subst:tls}} {{subst:Template:tlsu}}	{{subst:tlsf}} <template link>	{{tn}}	{{tla}}
code	code=yes	{{tl2}} {{tlx}} {{Template:tlxu}}	{{tlc}} <template link> {{tnull}}<template link>	{{subst:tlxs}}	{{subst:tlsc}} <template link>	—
monospace	plaincode=yes	—		{{subst:tltss}}	—
kbd	kbd=yes
bold	bold=yes	{{tlb}}	—
bold+code	bold=yes|code=yes	{{tlxb}}
italic+code	italic=yes|code=yes	{{tlxi}}

Other formatting templates

Templates producing specialised formatting effects for given templates, modules or parameters

Code example	Effect	Notes
{{Tj|Hatnote|Some text|selfref: yes|category: no|lang: fr}}	{{Hatnote | Some text | selfref = yes | category = no | lang = fr }}	Supports colors, placeholder texts, named and unnamed parameters
<syntaxhighlight lang="wikitext"> {{Hatnote | Some text | selfref = yes | category = no | lang = fr }} </syntaxhighlight>	{{Hatnote | Some text | selfref = yes | category = no | lang = fr }}	Same as above
{{Tji|Hatnote|Some text|selfref: yes|category: no|lang: fr}}	{{Hatnote|Some text|selfref=yes|category=no|lang=fr}}	Supports colors, placeholder texts, named and unnamed parameters
<syntaxhighlight lang="wikitext" inline>{{Hatnote|Some text|selfref=yes|category=no|lang=fr}}</syntaxhighlight>	{{Hatnote|Some text|selfref=yes|category=no|lang=fr}}	Same as above
{{tl2|Hatnote|lang=fr}}	{{hatnote}}	Supports linking to sister projects (e.g., fr:Hatnote)
{{demo|<nowiki>{{Hatnote|lang=fr|Some text}}</nowiki>}}	{{hatnote|lang=fr|Some text}} Some text	Shows code and example
{{tln|Hatnote}}	Template:Hatnote	Produces a normal link to the template
{{elc|Template:Hatnote}} {{elc|Template:Hatnote|Hatnote}}	[[Template:Hatnote]] [[Template:Hatnote|Hatnote]]	Formats wikilink, with optional piped link text and blended suffix
{{ml|Example|hello}}	{{#invoke:Example|hello}}	Counterpart to {{tl}} for linking to Lua modules
{{mfl|Example|hello}}	{{#invoke:Example|hello}}	Similar to {{ml}}, but expects the function to be documented and creates a link to the corresponding section
{{mlx|Example|hello}}	{{#invoke:Example|hello}}	Counterpart to {{tlx}} for linking to Lua modules
{{ml-lua|Module:Example}}	require('Module:Example')	Link to Lua modules and built-in libraries, showing Lua code.
{{para|title|<var>book title</var>}}	|title=book title	Formats template parameters for display, with or without values
{{sclx|LASTING}}	[[WP:LASTING]]	Takes a shortcut suffix in project namespace and displays it with brackets and the WP: alias in a <code>...</code> tag.
{{tag|ref}} {{xtag|templatedata}}	<ref>...</ref> <templatedata>	Formats [X]HTML tags; can add content, choose opening, closing, or self-closing
{{dtl|Ping project}}	{{d:Ping project}}	Wikidata counterpart to {{tl}}
{{pf|if}} {{pf|if|{{{1}}}|true|false}}	{{#if}} {{#if:{{{1}}}|true|false}}	Parser function equivalent to {{tl}}
{{magic word|uc:}}	{{uc:}}	Magic word links

With utility links

Templates producing utility links for a given template (Hatnote used here as example)

Code example	Effect
{{lt|Hatnote}}	Template:Hatnote (edit | talk | history | links | watch | logs)
{{lts|Hatnote}}	Template:Hatnote(edit talk links history)
{{t links|Hatnote}}	{{Hatnote}} (edit talk history links # /subpages /doc /doc edit /sbox /sbox diff /test)
{{tfd links|Hatnote}}	Template:Hatnote (talk · history · transclusions · logs · subpages)
{{tetl|Hatnote}}	{{Hatnote}} links talk edit
{{tsetl|Hatnote}}	{{subst:Hatnote}}  links talk edit
{{ti|Hatnote}}	Template:Hatnote (talk⧼dot-separator⧽links⧼dot-separator⧽edit)
{{tic|Hatnote}}	Template:Hatnote (talk links edit)
{{tim|Hatnote}}	m:Template:Hatnote (backlinks edit)
{{tiw|Hatnote}}	Template:Hatnote (backlinks edit)
{{tlt|Hatnote}}	{{Hatnote}} (talk)
{{ttl|Hatnote}}	{{Hatnote}} (t/l)
{{twlh|Hatnote}}	Template:Hatnote (links, talk)

The above documentation is transcluded from Nhwɛdo:Tlg/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Subpages of this template.