Template:Dc2/doc

Usage

The {{deprecated code}} template (easiest used from its {{dc}} redirect) can be used to indicate, e.g. in template documentation or Wikipedia articles on things like HTML specifications, code that has been deprecated and should not normally be used. It can also be used to indicate other deleted or deprecated material. On the technical level it is a CSS-styled <del>...</del> that greys out the text (the near-universal sign in computing and computing documentation for "doesn't work", "don't do this", "bad code", "ignore", "option not available", etc.), and removes that element's usual strikethrough (CSS: "line-through") rendering, which makes the content hard to read. If you really want that line-through, use the {{dc2}} (AKA {{dcs}}) variant to do this; it is otherwise identical.

Note: This template does not apply a monospaced font. This is so that it can be used inside an existing code (or non-code) block and inherit its font style. If necessary, wrap the template in one of <code>...</code> (source code), <kbd>...</kbd> (example input), or <samp>...</samp> (example output) as semantically appropriate. If you want monospace without semantic markup like <code>, you can use the alternative templates {{mxtd}}: Template:Mxtd, or {{!mxt}}: Example text.

Parameters

• |1=   the content to be marked as deprecated
• |2= or |title= a mouse-over "tooltip" (in some browsers, anyway), e.g. for briefly explaining the deprecation, e.g. "Deprecated since HTML 3.0" or "Breaks infobox formatting"
• |red=y   make the text red instead of grey, for indicating dangerous/error/forbidden things (a shortcut for this is {{dcr}})
• |class=   assign a CSS class
• |id=   assign an HTML ID for #linking and other purposes (must be unique on the page and start with an alphabetic letter)
• |style=   add additional CSS styling (can be used to add

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:

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

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

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:

is well spaced:

foo    quux.

versus:

which is going to be visually confusing for many:

foo quux.

because "foo" and "" will seem more closely associated than "" and ""; 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 and are valid values, as are , , , , 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 as

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 as

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 Dc2

See also

• {{codett}}, wrapper for this template that removes background and border styling
• {{mono}}, monospaced font only
• {{param value}}, monospaced; friendly handling for blank space
• {{Syntaxhighlight}}
• {{kbd}}, for keyboard input
• Help:Wiki markup

back in if you want that formatting; a shortcut for this is {{dc2}} or {{dcs}})

Examples

• {{dc|deprecated}} yields: deprecated
• {{dcr|deprecated}} yields: deprecated
• {{dc2|deprecated}} yields: deprecated
• {{dcs|deprecated}} yields: deprecated

See also

• {{xtd}} and related templates for indicating deprecated, good, bad, and neutral examples in guidelines, how-tos, and template documentation.
  • {{mxtd}} in this template group (Template:Mxtd) is an alternative to {{dc}}.
  • {{!mxt}} in this template group (example output here) is an alternative to {{dcr}}.
• {{strongbad}} – for introducing something as deprecated or issuing some other warning in documentation, e.g.: {{strongbad|Not for use in mainspace.}}