Template:Template link general/doc

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Template link general.

---

{{Tlg}} (abbreviating "[T]emplate [l]ink (with) [g]eneral (options)") is a generalized version of the {{Tl}} ("Template link") template. It can be used to replace or implement {{Tl}} and related templates such as {{Tlb}}, {{Tlx}}, etc.

Usage

{{Template link general |1= }}

Or use the shorthand

{{Tlg|… parameters as described …}}

Template parameters

 Parameter text is empty

<templatedata>JSON</templatedata> ./. {{TemplateBox}}

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

---

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

---

Wikipedia's help about TemplateData • Commons-specific information

Template link general

Template parameters

Parameter		Description	Type	Status
Link Brackets?	brace	Whether to include both brackets as part of the linked template name. Default 0 Auto value 1	Boolean	optional
Link Inner Brackets?	braceinside	Whether to include the inner brackets as part of the linked template name. Default 0 Auto value 1	Boolean	optional
Bold?	bold	Whether to add “<span style="font-weight:bolder">” around the linked template name. Default 0 Auto value 1	Boolean	optional
Code?	code	Whether to add “<code>”. Default 0 Auto value 1	Boolean	optional
Italic?	italic	Whether to add “<span style="font-style:italic">” around parameters. Default 0 Auto value 1	Boolean	optional
Kbd?	kbd	Whether to add “<kbd>”. Default 0 Auto value 1	Boolean	optional
Mono?	mono	Whether to add “<span style="font-family:monospace">”. Default 0 Auto value 1	Boolean	optional
No Link?	nolink	Whether to not create a link to the template. Default 0 Auto value 1	Boolean	optional
No Wrap?	nowrap	Whether to add “<span style="white-space:nowrap">”. Default 0 Auto value 1	Boolean	optional
No Wrap Name?	nowrapname	Whether to add “<span style="white-space:nowrap">” around the linked template name. Default 0 Auto value 1	Boolean	optional
Plain Code?	plaincode	Whether to add “<code style="background:transparent;border:none">”. Default 0 Auto value 1	Boolean	optional
Subst?	subst	Whether to use “subst:”. Default 0 Auto value 1	Boolean	optional
Link Subst?	link subst	Whether the “subst:” prefix should link to the help page on substitution. Default 0 Auto value 1	Boolean	optional
Display Text	alttext	Displayed link text. Default {{{1}}}	Line	optional
Template	1	Linked template name	Template	required
Parameter 1	2	First parameter value	Content	optional
Parameter 2	3	Second parameter value	Content	optional
Parameter 3	4	Third parameter value	Content	optional
Parameter 4	5	Fourth parameter value	Content	optional
Parameter 5	6	Fifth parameter value	Content	optional
Parameter 6	7	Sixth parameter value	Content	optional
Parameter 7	8	Seventh parameter value	Content	optional
Parameter 8	9	Eighth parameter value	Content	optional
Parameter 9	10	Ninth parameter value	Content	optional
Parameter 10	11	Tenth parameter value	Content	optional

Edit parameter translations

Additional information

The template is intended to be used in the following namespaces: all namespaces

The template is intended to be used by the following user groups: all users

Parameters

Named

With the exception of alttext, {{Tlg}}'s named parameters are toggles that are either omitted (default) or activated (by being assigned a value such as "on", "yes", "true", "include", etc.). They may be included in any order (see Examples below):

Parameter	Action	As in
brace	Include braces as part of the template link
braceinside	Include innermost braces as part of the template link	{{Tlw}}
bold boldlink boldname	Renders the template link/name in bold	{{Tlb}}, {{Tlx}}, etc.
code	Display output using HTML ‎<code>...‎</code> tags (monospaced font)	{{Tlc}}, {{Tlx}}, etc.
plaincode	Uses ‎<code style="background-color: var(--background-color-base, #f8f9fa); border: none;">...‎</code>
kbd	Display output using HTML ‎<kbd>...‎</kbd> tags (monospaced font)	{{Tltt}}, {{Tltt2}}, etc.
italic italics	Display any parameters accompanying the template link/name in italic type	{{Tlxi}}
nolink	Don't render the template name as a link	{{Tlf}}
nowrap	Prevent the insertion of line breaks (word wrap) in the output	{{Tlp}}, {{Tlf}}, etc.
nowrapname	Prevent word wrapping in the output of template name/link (parameters will wrap if needed)
subst	Include a subst: prefix before the template link/name	{{Tls}}
alttext=text	Use text as the label for the template link	{{Tla}}

Unnamed (Positional)

{{Tlg}} may take up to ten unnamed parameters as parameters accompanying the template link (or name); see Examples below.

Examples

Note

On the source sister projects, en.wikipedia and Meta, X0, X1, X2, …, X9 are sandbox templates for experimentation on involved templates that need be in template space. An auto-cleansing software facility exists that might be used to duplicate the facility on other Sister projects.

Code	Output	Remarks
{{Tlg|Termometro}}	{{Termometro}}	template does not exist. Be aware with linking to non-existing templates, although desired.
{{Tlg|Ok}}	{{Ok}}	Ok template does exist
{{Tlg|Convert|<nowiki>14|m|ftin|abbr=out|sp=us</nowiki>}}	{{Convert|14|m|ftin|abbr=out|sp=us}}	Unlimited parameters as one ‎<nowiki>...‎</nowiki> string
{{Tlg|Abc}}	{{Abc}}
{{Tlg|abC}}	{{abC}}	Template names are case-sensitive
{{Tlg|abc}}	{{abc}}	The first letter of a template's name is case-insensitive, though
{{Tlg|Abc|{{spaces}}{{{1}}}{{spaces}}}}	{{Abc| {{{1}}} }}	Using {{Spaces}} before and after {{{1}}} parameter.
{{Tlg|X0}}	{{X0}}
{{Tlg|X0|code=on}}	{{X0}}	<code> style
{{Tlg|X0|plaincode=on}}	{{X0}}	plaincode style
{{Tlg|X0|kbd=on}}	{{X0}}	<kbd> style
{{Tlg|X0|bold=on}}	{{X0}}	bold link/name
{{Tlg|X1|one|italic=on}}	{{X1|one}}	parameter/s in italics
{{Tlg|X0|nolink=on}}	{{X0}}
{{Tlg|X0|subst=on}}	{{subst:X0}}
{{Tlg|X0|brace=on}}	{{X0}}	all braces in link
{{Tlg|X0|braceinside=on}}	{{X0}}	inside braces in link
{{Tlg|X0|alttext=x0 link}}	{{x0 link}}
{{Tlg|X0|bold=on|code=on|brace=on}}	{{X0}}	No reason you can't combine multiple parameter settings
{{Tlg|X1|one}}	{{X1|one}}
{{Tlg|X2|one|two}}	{{X2|one|two}}
{{Tlg|X2|bold=on|code=on|one|two}}	{{X2|one|two}}	Can combine named and anonymous parameters …
{{Tlg|X2|one|two|bold=on|code=on}}	{{X2|one|two}}	… in any order …
{{Tlg|X2|one|code=on|two|bold=on|three}}	{{X2|one|two|three}}	… even intermixed …
{{Tlg|X2|one|code=on|two|bold=on|three|italic=on}}	{{X2|one|two|three}}	… with many different configurations.
{{Tlg|X3|1|2|3|4|5|6|7|...}}	{{X3|1|2|3|4|5|6|7|8|9|10}}
{{Tlg|X4|1|2|3|4|5|6|7|...}}	{{X4|1|2|3|4|5|6|7|8|9|10|11}}	up to 10 parameters, then …
{{Tlg|X5|1|2|3|4|5|6|7|...}}	{{X5|1|2|3|4|5|6|7|8|9|10|11}}	&#124; for more
{{Tlg}}	{{Template:Template link general/doc}}	with no arguments, the current page name is substituted
{{Tlg|X1|x=u}}	{{X1}}	= won't work
{{Tlg|X1|x&#61;u}}	{{X1|x=u}}	&#61; is okay
{{Tlg|X1|x{{=}}u}}	{{X1|x=u}}	{{=}} is okay (see equality symbol template)
{{Tlg|X1|x<nowiki>=</nowiki>u}}	{{X1|x=u}}	sticky nowiki is okay
{{Tlg|X2||two||}}	{{X2|two}}	empty parameters work too, even at the end
{{Tlg|X2|3=two|2=one}}	{{X2|one|two}}	right to left okay

Wrapping of long names (default)

Code	Output
{{Tlg|Long template name that would wrap to new line|this is a long value for the 1st parameter that would wrap}}	{{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
{{Tlg|nowrap=on|Long template name that would wrap to new line|long value for the 1st parameter that would wrap}}	{{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
{{Tlg|nowrapname=on|Long template name that would wrap to new line|long value for the 1st parameter that would wrap}}	{{Long template name that would wrap to new line|long value for the 1st parameter that would wrap}}

See also

1. REDIRECT Commons:Link templates/Template links