Template:Param/doc: Difference between revisions

This is a documentation subpage for Template:Param.
It contains usage information, categories and other content that is not part of the original Template page.

Not to be confused with Template:Para.

This template is for giving examples of template parameter source code which is useful in template documentation and talk page discussions of template code.

Usage

{{param|foo}} → {{{foo}}}

{{param|foo|tag=kbd}} → {{{foo}}}

{{param|foo|bar}} → {{{foo|bar}}}

{{param|foo|{{param|bar|nested=yes}}}} → {{{foo|{{{bar}}}}}}

{{param|foo|{{param|bar|{{param|baz|derp|nested=yes}}|nested=yes}}}} → {{{foo|{{{bar|{{{baz|derp}}}}}}}}}

Examples involving {{Para }}

{{para|foo|{{param|bar}}}} → |foo={{{bar}}}

{{para|foo|{{param|bar|nested=yes}}}} → |foo={{{bar}}}

{{para|foo}}{{param|bar}} → |foo={{{bar}}}

{{para|foo|{{var|bar}}}} → |foo=bar

Template	Example output	Use
{{strong}}	Important!	To indicate <strong> importance, seriousness, or urgency instead of just simple typographical boldfacing
{{strongbad}}	"Never use ..."	Same as {{strong}} but in red
{{stronggood}}	"Only use ..."	Same as {{strong}} but in green
{{em}}	"An emphatic phrase"	To indicate <em> stress emphasis (not just purely typographical italicization like for book titles or foreign terms)
{{var}}	`strPrefix`	To indicate text is a variable name. Use for any variable names except those including "I" (uppercase i) and/or "l" (lowercase L); for these, {{var serif}} should be used to ensure a noticeable distinction
{{var serif}}	`strIllustratePrefix`	(see {{var}} above)
{{tld}}	`{{DEFAULTSORT:Y, X}}`	To display wikicode variables and magic words as they would appear in code
{{para}}	`\|year=2008`	To display template parameters with or without values
{{param}}	`{{{title\|alt}}}`	To display parameters as used in code (i.e. with triple braces), especially to indicate relationships between them. May be combined with {{para}} above
{{tjp}}	\|selfref=yes	To display template parameters with colors (as they would appear in the {{Tj }} and {{Tji }} templates)
{{param value}}	`··2·blanks·fore·and·aft··`	To display parameter values lightly bordered; replaces <code>...</code>, especially when value contains embedded or leading/trailing blanks; visualized here with middot (·) but can use ␠, ▯, or any character.
{{tlx}} etc.	{{Template\|`1`\|`2`\|...\|`10`}}	To display a template call (with or without parameters and values) as code
{{tji}}	{{hatnote\|Hello\|selfref=yes\|category=no}}	To showcase with colors in horizontal format the syntax of any template, while providing an easy way to display placeholder texts using colons as separators
{{tag}}	"The `‎<img>...‎</img>` tags ..."	To render HTML elements ("tags") in prose
{{code}}/{{codett}}	"Ensure the alt= parameter ..."	To indicate text is source code. To nest other templates within {{code}}, use `‎<code>...‎</code>`. {{Codett }} differs only in styling: someMethod becomes someMethod
{{PreCode}}	"FORTH has keyword `?BRANCH`."	Like {{code}}, but prevents line breaks inside the code. Only for very short code parts.
{{subst :codenowiki}}	`{{small\|small text example}}`	To wrap example code in <code><nowiki>...</nowiki></code>
{{subst :kbdnowiki}}	`{{large\|large text example}}`	To wrap example code in <kbd><nowiki>...</nowiki></kbd>
{{syntaxhighlight}}	_{[this is a block template]}	( or {{sxhl}} ) Wrapper for `‎<syntaxhighlight>...‎</syntaxhighlight>`, but will wrap overflowing text
{{deprecated code}}	"Do not use `‎<blink>`."	( or {{dc}} ) To indicate deprecated source code in template documentation, articles on HTML specs, etc. The {{dc2}} variant uses strike-through (`‎<blink>`) while {{dcr}} uses red (`‎<blink>`).
{{pre}}	_{[this is a block template]}	For larger blocks of source code and other pre-formatted text
{{tj}}	_{[this is a block template]}	To showcase with colors and multiple lines (vertical format) the syntax of any template, while providing an easy way to display placeholder texts using colons as separators
{{quote}}	_{[this is a block template]}	For block quotations (only – never for non-quotations)
{{block indent}}	_{[this is a block template]}	For indented blocks of material; visually identical to {{quote}} but without quote markup
{{kbd}}	`user input`	To indicate user input
{{key press}}	`Ctrl`+`x`	To indicate specific-keystroke input, including combinations
{{key top}}	`Left shift`	Similar; includes more symbols, but does not directly support combinations
{{button}}	<span class="nowrap" title="<translate nowrap> This is not a clickable button; it illustrates the button one should find.</translate>" style="padding:.2em .6em; border:1px solid; border-color:#AAA #555 #555 #AAA; border-radius: 3px; background-color: #F2F2F2; background-image: linear-gradient(to bottom, #FCFCFC, #E0E0E0); ">Don't save	To indicate a button in a user interface
{{samp}}	`example output`	To indicate sample or example output

Template:Param/doc: Difference between revisions

Revision as of 10:39, 28 May 2024

Usage

Examples involving {{Para }}

See also