Template:Deprecated code 2: Difference between revisions
SMcCandlish (talk | contribs) test |
SMcCandlish (talk | contribs) I think this will do it |
||
| Line 1: | Line 1: | ||
<del style="color:Grey; text-decoration:none; {{#if:{{{style|}}}|{{{style}}}|}}" {{#if:{{{id|}}}|id="{{{id}}}|}}" {{#if:{{{class|}}}|class="{{{class}}}|}}" {{#if:{{{title|{{{2|}}}}}}|title="{{{title|{{{2}}}}}}"|}}><span style="color:{{#if:{{{red|}}}|#8B0000|DimGrey}};">{{{1}}}</span></del><noinclude> |
|||
<span style="color:grey;">{{deprecated code |
|||
|1={{{1}}} |
|||
|2={{{title|{{{2|}}}}}} |
|||
|red={{{red|}}} |
|||
|class={{{class|}}} |
|||
|id={{{id}}} |
|||
|style=text-decoration:line-through;{{{style|}}} |
|||
}}</span><noinclude> |
|||
{{dc2|foo}} |
{{dc2|foo}} |
||
{{documentation}} |
|||
<!--Categories and interwikis go on the /doc subpage.--> |
|||
</noinclude> |
</noinclude> |
||
Revision as of 20:48, 4 February 2012
{{{1}}}
foo
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}}: Example text, 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=ymake 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 addtext-decoration:line-through;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.{{strongbad}}– for introducing something as deprecated or issuing some other warning in documentation, e.g.:{{strongbad|Not for use in mainspace.}}