Template:Var serif/doc

This is a documentation subpage for Template:Var serif.
It may contain usage information, categories and other content that is not part of the original template page.

Usage

This template is to help facilitate the displaying of variable names (in mathematics, computer source code, etc.) with the semantically correct <var>...</var>, which also renders the variable in italics, as is customary, and to do so in a serif font. This is specifically for the use of the characters "I" (upper-case i) and "l" (lower-case L), which in many sans-serif fonts can be difficult to distinguish. The template also very slightly adjusts the font size of the enclosed variable, to account for typical difference in x-height between non-fancy serif (e.g., Times and Times New Roman) and sans-serif (e.g. Arial and Helvetica) typefaces. The template should not be used generally, but only for "I" and "l", and perhaps other cases where a known visual ambiguity can be shown to exist in common sans-serif fonts for readers without acute vision. It is recommended to use {{var|1}} rather than {{var serif|1}} for "1" (numeral one), as it is usually more clearly distinguishable from "I" and "l" in sans-serif than serif fonts.

{{Var serif}} need not be used for variables that simply contain "I" or "l", only for cases in which readers are likely to be unable to distinguish them visually.

The {{var serif}} method is preferred to simply italicizing and using inline style to specify the font, for accessibility, content/presentation separation, semantic Web, and metadata reasons; XHTML's <var> element has semantic meaning, while simple font changes like italicizing does not.

Because the font styling in the template is done entirely with CSS, it has no effect at all upon content semantics, nor does it change the output for users of screen reader software.

Example:

{{var serif|I}}

outputs:

<var style="font-size:118%;font-family:serif;">I</var>

which renders as:

Page Template:Var serif/styles.css has no content.I

Comparisons: {{var|I}} = I; {{var|l}} = l; {{var|1}} = 1; {{var serif|I}} = Page Template:Var serif/styles.css has no content.I; {{var serif|l}} = Page Template:Var serif/styles.css has no content.l; {{var serif|1}} = Page Template:Var serif/styles.css has no content.1

Please note that {{var serif}} is not a panacea; its treatment of the numeral "1" is easily mistaken for the letter "l" (lower-case "L") in many serif fonts.

Recommended usage: {{var serif|I}} = Page Template:Var serif/styles.css has no content.I; {{var serif|l}} = Page Template:Var serif/styles.css has no content.l; {{var|1}} = 1; {{var|variable}} for any other variable

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Var serif

No description.

Template parameters
Parameter		Description	Type	Status
1	`1`	no description	Unknown	optional
class	`class`	no description	Unknown	optional
id	`id`	no description	Unknown	optional
style	`style`	no description	Unknown	optional
lang	`lang`	no description	Unknown	optional
title	`title`	no description	Unknown	optional

Page Template:Var serif/styles.css has no content.

Semantic markup templates

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

This is a documentation subpage for Template:Var serif.
It may contain usage information, categories and other content that is not part of the original template page.

Usage

Wraps a short span of text in <syntaxhighlight> tags (see mw:Extension:SyntaxHighlight). This template should be used for short samples; longer content should use <pre>...</pre> or <syntaxhighlight>...</syntaxhighlight>. See Help:Wiki markup for an explanation of what the various tags do.

If the content includes an equals sign (=), you must specify the parameter explicitly: {{code|1=date=30 Feb 2010}}.

The template uses the <syntaxhighlight> tag with the attribute inline=1. This works like the combination of the <code> and <nowiki> tags, applied to the expanded wikitext. For example, {{code|some '''wiki''' text}} will not render the word "wiki" in bold, and will render the tripled-single-quotes:

Template loop detected: Template:Code

However, {{code|a {{template}} call}} will still invoke the template:

Template loop detected: Template:Code

Use <nowiki>...</nowiki> around the template name to avoid this problem:

Template loop detected: Template:Code

When used inline with regular text, {{code}} generally looks best and is easiest to read when it is explicitly spaced apart from the regular text:

Template loop detected: Template:Code

is well spaced:

foo Template loop detected: Template:Code quux.

versus:

Template loop detected: Template:Code

which is going to be visually confusing for many:

foo Template loop detected: Template:Code quux.

because "foo" and "Template loop detected: Template:Code" will seem more closely associated than "Template loop detected: Template:Code" and "Template loop detected: Template:Code"; the width of the space character in a monospaced font is almost always larger than in a proportional font.

Use parameter {{{2}}} (unnamed, as |2=, or more explicitly as |lang=) to specify a language for mw:Extension:SyntaxHighlight. This option defaults to plain-text, i.e. no highlighting. There is no highlighting option for wikitext as a markup language, though Template loop detected: Template:Code and Template loop detected: Template:Code are valid values, as are Template loop detected: Template:Code, Template loop detected: Template:Code, Template loop detected: Template:Code, Template loop detected: Template:Code, Template loop detected: Template:Code and many others. Attempting to use an invalid one causes a list of valid ones to be displayed in place of the template output, when the page is previewed or saved.

This template does not need to be substituted.

Examples

Markup	Renders asScript error: No such module "For loop".

Included templates

Embedded templates do not function as expected inside {{code}}; for longer, free-form blocks of code, which can contain templates such as {{var}} and {{samp}}, use <code>...</code> as a wrapper instead of this template.

Templates used inside {{code}} expose the rendered HTML— this can be useful. For example:

Markup	Renders asScript error: No such module "For loop".

The above example shows the HTML rendered by the citation template, including the hidden metadata.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Var serif

Script error: No such module "Format TemplateData".

Usage

If the content includes an equals sign (=), you must specify the parameter explicitly: {{code|1=date=30 Feb 2010}}.

Template loop detected: Template:Code

However, {{code|a {{template}} call}} will still invoke the template:

Template loop detected: Template:Code

Use <nowiki>...</nowiki> around the template name to avoid this problem:

Template loop detected: Template:Code

When used inline with regular text, {{code}} generally looks best and is easiest to read when it is explicitly spaced apart from the regular text:

Template loop detected: Template:Code

is well spaced:

foo Template loop detected: Template:Code quux.

versus:

Template loop detected: Template:Code

which is going to be visually confusing for many:

foo Template loop detected: Template:Code quux.

This template does not need to be substituted.

Examples

Markup	Renders asScript error: No such module "For loop".

Included templates

Templates used inside {{code}} expose the rendered HTML— this can be useful. For example:

Markup	Renders asScript error: No such module "For loop".

The above example shows the HTML rendered by the citation template, including the hidden metadata.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Var serif

Script error: No such module "Format TemplateData".

Usage

If the content includes an equals sign (=), you must specify the parameter explicitly: {{code|1=date=30 Feb 2010}}.

Template loop detected: Template:Code

However, {{code|a {{template}} call}} will still invoke the template:

Template loop detected: Template:Code

Use <nowiki>...</nowiki> around the template name to avoid this problem:

Template loop detected: Template:Code

When used inline with regular text, {{code}} generally looks best and is easiest to read when it is explicitly spaced apart from the regular text:

Template loop detected: Template:Code

is well spaced:

foo Template loop detected: Template:Code quux.

versus:

Template loop detected: Template:Code

which is going to be visually confusing for many:

foo Template loop detected: Template:Code quux.

This template does not need to be substituted.

Examples

Markup	Renders asScript error: No such module "For loop".

Included templates

Templates used inside {{code}} expose the rendered HTML— this can be useful. For example:

Markup	Renders asScript error: No such module "For loop".

The above example shows the HTML rendered by the citation template, including the hidden metadata.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Var serif

Script error: No such module "Format TemplateData".

Usage

If the content includes an equals sign (=), you must specify the parameter explicitly: {{code|1=date=30 Feb 2010}}.

Template loop detected: Template:Code

However, {{code|a {{template}} call}} will still invoke the template:

Template loop detected: Template:Code

Use <nowiki>...</nowiki> around the template name to avoid this problem:

Template loop detected: Template:Code

When used inline with regular text, {{code}} generally looks best and is easiest to read when it is explicitly spaced apart from the regular text:

Template loop detected: Template:Code

is well spaced:

foo Template loop detected: Template:Code quux.

versus:

Template loop detected: Template:Code

which is going to be visually confusing for many:

foo Template loop detected: Template:Code quux.

This template does not need to be substituted.

Examples

Markup	Renders asScript error: No such module "For loop".

Included templates

Templates used inside {{code}} expose the rendered HTML— this can be useful. For example:

Markup	Renders asScript error: No such module "For loop".

The above example shows the HTML rendered by the citation template, including the hidden metadata.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Var serif

Script error: No such module "Format TemplateData".

Usage

If the content includes an equals sign (=), you must specify the parameter explicitly: {{code|1=date=30 Feb 2010}}.

Template loop detected: Template:Code

However, {{code|a {{template}} call}} will still invoke the template:

Template loop detected: Template:Code

Use <nowiki>...</nowiki> around the template name to avoid this problem:

Template loop detected: Template:Code

When used inline with regular text, {{code}} generally looks best and is easiest to read when it is explicitly spaced apart from the regular text:

Template loop detected: Template:Code

is well spaced:

foo Template loop detected: Template:Code quux.

versus:

Template loop detected: Template:Code

which is going to be visually confusing for many:

foo Template loop detected: Template:Code quux.

This template does not need to be substituted.

Examples

Markup	Renders asScript error: No such module "For loop".

Included templates

Templates used inside {{code}} expose the rendered HTML— this can be useful. For example:

Markup	Renders asScript error: No such module "For loop".

The above example shows the HTML rendered by the citation template, including the hidden metadata.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Var serif

Script error: No such module "Format TemplateData".

Contents

Usage

TemplateData

Usage

Examples

Included templates

TemplateData

See also

Usage

Examples

Included templates

TemplateData

See also

Usage

Examples

Included templates

TemplateData

See also

Usage

Examples

Included templates

TemplateData

See also

Usage

Examples

Included templates

TemplateData

See also

Navigation menu

Page actions

Page actions

Personal tools

Navigation

Search

Tools