Template:Xtd

Example text

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

Not to be confused with Category:Text color templates.

This page is being depreciated and related templates produce an inline typeface change suitable to render example text on Wikipedia's help pages.

Using example-formatting templates in general

The category of example-formatting templates is used frequently in non-mainspace general help pages such as Wikipedia:Manual of Style (MOS) when inline typeface changes are needed.

This page is being depreciated changes the typeface to serif and the text color to green. Example

For cases where the serif typeface is not desirable (e.g. in blocks of computer code), use This page is being depreciated, which substitutes boldfacing, or This page is being depreciated, which substitutes a monospaced font. For style examples that break to their own line (e.g. paragraphs), use This page is being depreciated.

For examples of bad/wrong style, in red, use This page is being depreciated, This page is being depreciated, This page is being depreciated, or This page is being depreciated, respectively to the previous paragraph (the addition of the ! indicates the opposite effect). Use This page is being depreciated for bad/wrong style with strikethrough formatting.

The This page is being depreciated template exists for deprecated examples. Its alias This page is being depreciated (for "grey") can be used to indicate uncertain, unavailable, disabled, lorem, etc., examples without implying deprecation. The bold, sans-serif equivalent is This page is being depreciated (and This page is being depreciated alias). The mono-spaced equivalent is This page is being depreciated.

The This page is being depreciated template is for neutral examples, and has no color change, but is otherwise identical to This page is being depreciated in that it changes to serif typeface. It can be used with {{xt}} and {{!xt}} to indicate usage that is neither advised nor advised against or deprecated. The bold, sans-serif equivalent is This page is being depreciated. The mono-spaced equivalent is This page is being depreciated.

Parameters

• |text here or |1=text here – The text to which to apply the markup. As with all templates, when the text has any equals characters ("="), explicitly prefix the text with |1= or the template will break.
• |title=tooltip text here – Takes text, which cannot be marked up in any way, and displays it as a pop-up "tooltip" (in most browsers) when the cursor hovers over the span

Accessibility

The accompanying change in typeface to a serif or monospaced type style (as in example text) is to make it fully accessible for those with color blindness.

Keep accessibility more broadly in mind, and never construct examples such that a blind person, who may not be able to see the coloration, boldfacing, or monospace font change, cannot understand the examples. Especially indicate, with terms like "not", "don't", "wrong:", etc., that a negative example is a negative one, or with "deprecated", "avoid", etc., that deprecated material is deprecated.

Examples of {{xt}} syntax and result

What you write

...for example, {{xt|1=''T'' = 293.15 K}}, but not {{!xt|1=''m''=5.4kg}}.

What you get

...for example, T = 293.15 K, but not m=5.4kg.

Template class	Output typeface
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change
This page is being depreciated	inline typeface change

User CSS for a monospaced coding font

Change system-default monospace font:

To consistently use a monospaced font with well-designed characters for coding so as to clearly distinguish between l, 1, and I, and between O and 0, and between -, −, –, and —, the system-default monospaced font can be changed:

If like it as-is, you can simply @import (transclude) it: see meta:User:SMcCandlish/codefont.css for quick instructions.

Otherwise, copy one of the code snippets below to your Special:MyPage/common.css or meta:Special:MyPage/global.css page, replacing "Roboto Mono" in the code with your preferred coding font. (Roboto Mono was used in this example as it is good, free coding font, for user-editable material on the wiki).

This code will:

• Apply a consistent monospace font of choice to all the normally monospaced HTML elements like This page is being depreciated, This page is being depreciated, etc.
• Fallback to system-default monospace font, should the chosen font be unavailable or lack the necessary characters.
• Do the same for the output of all Example-formatting templates, such as This page is being depreciated and This page is being depreciated.
• Apply to additional site-wide classes identified so far (e.g., .monospaced) that output as monospace.
• Make the three most frequently encountered editing fields also use this font stack: the main editing window, the edit summary line, and the search entry box.
• If any additional classes are known that should be added, please update this page or mention it on the talk page.

Horizontal style

/* Use my font, when available, for code */
code, pre, samp, kbd, tt, .example-mono, .userlinks-username, .monospaced, .keyboard-key, .button, .plaincode { font-family: "Roboto Mono", monospace !important; }
/*  Make some of the editable stuff monospaced */
#wpTextbox1, #wpSummary, #searchInput, #searchText { font-family: "Roboto Mono", monospace !important; }

Vertical style

/* Use my font, when available, for code */
code,
pre,
samp,
kbd,
tt,
.example-mono,
.userlinks-username,
.monospaced,
.keyboard-key,
.button
.plaincode {
  font-family: "Roboto Mono", monospace !important;
}
/*  Make some of the editable stuff monospaced */
#wpTextbox1,
#wpSummary,
#searchInput,
#searchText {
  font-family: "Roboto Mono", monospace !important;
}

Cleanup efforts

If you'd like to help clean up instances of the This page is being depreciated element – which has been discouraged since the 1990s, and should usually be replaced with This page is being depreciated (this may vary by context) – you can add something like the following to your common.css to make This page is being depreciated stick out like a sore thumb:

/* Flag bad code for cleanup */
tt { color: DarkRed; background: Pink; }

You can also do this with This page is being depreciated, This page is being depreciated, This page is being depreciated, and other deprecated elements. For CSS you can just import for this, see meta:User:SMcCandlish/lint.css.

See also

• This page is being depreciated inline positive example text, in green, with serif font
• This page is being depreciated same as {{xt}} but for blocks of text
• This page is being depreciated same as {{xt}} but uses bold instead of serif font
• This page is being depreciated same as {{xt}} but uses mono-spaced font (especially useful in source code)
   
• This page is being depreciated inline negative example text, in red, with serif font
• This page is being depreciated same as {{!xt}} but for blocks (i.e., same as {{xt2}} but red)
• This page is being depreciated same as {{!xt}} but uses boldface
• This page is being depreciated same as {{!xt}} but uses mono-spaced font; used for incorrect or strongly deprecated code/output/input examples and should usually be wrapped in This page is being depreciated, This page is being depreciated, or This page is being depreciated as appropriate; see also This page is being depreciated and its variants below
• This page is being depreciated same as {{!xt}} but also strikes through the text
• This page is being depreciated inline strongly deprecated or deleted material; This page is being depreciated variant has strikethrough (they both use the This page is being depreciated element, and do not add monospace font on their own; can be used in mainspace (articles), and where necessary wrapped in This page is being depreciated, This page is being depreciated, or This page is being depreciated); see also This page is being depreciated below
   
• This page is being depreciated inline deprecated (or uncertain, unavailable, lorem, etc.) example text, in grey
• This page is being depreciated same as {{xtd}} but uses boldface
• This page is being depreciated same as {{xtd}} but uses mono-spaced font
• This page is being depreciated inline deprecated or deleted material; (uses the This page is being depreciated element, and does not add monospace font on it own; can be used in mainspace (articles), and where necessary wrapped in This page is being depreciated, This page is being depreciated, or This page is being depreciated); see also This page is being depreciated above
   
• This page is being depreciated inline neutral example text, with no color change, when none of the above applies; used for "permissible" examples neither favored nor deprecated
• This page is being depreciated same as {{xtn}} but for blocks of text
• This page is being depreciated same as {{xtn}} but uses boldface; it still applies a CSS class, so it's not simply boldfacing
• This page is being depreciated same as {{xtn}} but uses mono-spaced font; this is a good template to use when the shaded box formatting of This page is being depreciated might be undesirable, or the semantics of it is incorrect in the context
   
• This page is being depreciated – for introducing something as deprecated or issuing some other warning in documentation, e.g.: Not for use in mainspace.

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