Template:Stronggood/doc
This is a documentation subpage for Template:Stronggood. It contains usage information, categories and other content or metadata that is not part of the original template. |
Usage
This template should not be used in mainspace (the article namespace). |
This template is used to insert a quick and easy positive notice with high visibility (because it is green) on project and discussion pages (like the following sentence). Only use this template on non-article pages. (It cannot actually be used in articles; it will generate an error.) In situations where color is not relevant (color blindness, screen readers, etc.), it renders exactly the same as {{strong}}
(to which it is a CSS-styled call). It is the opposite of the {{strongbad}}
template.
{{stronggood|important text}}
or, if the important text contains an equals sign:
{{stronggood|1=important text}}
These both render as:
- important text
It is safest to always use the |1 = syntax.
This template puts intentional and explicit <strong>...</strong>
(importance, seriousness, or urgency) HTML markup around the text provided as the first parameter.
Because some people are color blind, and some use screen readers, this template should not be used in a manner in which only the color indicates the difference between the content being marked up and other content; it's simply a visual aid for those who can use it.
Parameters
See Template:Strong#Optional parameters.
See also
{{strong}}
– same but not green (same color as surrounding text, usually black){{strongbad}}
– same but red{{em}}
– for italic rather than bold semantic emphasis
{{xt}}
inline positive example text, in green, with serif font{{xt2}}
same as{{xt}}
but for blocks of text{{bxt}}
same as{{xt}}
but uses bold instead of serif font{{mxt}}
same as{{xt}}
but uses mono-spaced font (especially useful in source code)
{{!xt}}
inline Template:!xt, in red, with serif font{{!xt2}}
same as{{!xt}}
but for blocks (i.e., same as{{xt2}}
but red){{!bxt}}
same as{{!xt}}
but uses Template:!bxt{{!mxt}}
same as{{!xt}}
but uses Template:!mxt; used for incorrect or strongly deprecated code/output/input examples and should usually be wrapped in<code>
,<samp>
, or<kbd>
as appropriate; see also{{dc}}
and its variants below{{!xts}}
same as{{xt}}
but also Template:!xts{{dcr}}
inline Template:Dcr;{{dc2}}
variant has Template:Dc2 (they both use the<del>
element, and do not add monospace font on their own; can be used in mainspace (articles), and where necessary wrapped in<code>
,<samp>
, or<kbd>
); see also{{dc}}
below
{{xtd}}
inline Template:Xtd, in grey{{bxtd}}
same as{{xtd}}
but uses Template:Bxtg{{mxtd}}
same as{{xtd}}
but uses Template:Mxtd{{dc}}
inline Template:Dc; (uses the<del>
element, and does not add monospace font on it own; can be used in mainspace (articles), and where necessary wrapped in<code>
,<samp>
, or<kbd>
); see also{{dcr}}
above
{{xtn}}
inline Template:Xtn, with no color change, when none of the above applies; used for "permissible" examples neither favored nor deprecated{{xtn2}}
same as{{xtn}}
but for blocks of text{{bxtn}}
same as{{xtn}}
but uses Template:Bxtn; it still applies a CSS class, so it's not simply boldfacing{{mxtn}}
same as{{xtn}}
but uses Template:Mxtn; this is a good template to use when the shaded box formatting of<code>...</code>
might be undesirable, or the semantics of it is incorrect in the context
{{strongbad}}
– for introducing something as deprecated or issuing some other warning in documentation, e.g.: Not for use in mainspace.