الگو:Xt/توضیحات

از ویکی حقوق
پرش به ناوبری پرش به جستجو


استفاده

Use template {{xt}} (the name of which stands for "example text") in order to format examples of style, especially when using quotation marks or italics could be confusing. This changes the given text to the serif typeface and green color. This template is used frequently in the Manual of Style when inline typeface changes are needed. For cases where the serif typeface is not desirable (e.g. in blocks of computer code), use {{bxt}}, which substitutes boldfacing, or {{mxt}}, which substitutes a mono-spaced font. For style examples that break to their own line (e.g. paragraphs), use {{xt2}}.

For examples of bad/wrong style, in red, use {{!xt}}, {{!bxt}}, {{!mxt}}, or {{!xt2}}, respectively.

The {{xtd}} template exists for deprecated examples. Its alias {{xtg}} (for "grey") can be used to indicate uncertain, unavailable, disabled, lorem, etc., examples without implying deprecation. The bold, sans-serif equivalent is {{bxtd}} (and {{bxtg}} alias). The mono-spaced equivalent is {{mxtd}}.

The {{xtn}} template is for neutral examples, and has no color change, but is otherwise identical to {{xt}}. 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 {{bxtn}}.

These templates cannot be used in mainspace (articles). Attempting to do so will throw an error.

These templates are not for use as quotation markup in talk pages; use {{tq}} instead.


پارامترها

  • |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

دسترسی

The accompanying change in typeface to a serif or mono-spaced type style, (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.

نمونه‌ها

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.
What you type What you get
this is an {{xt|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{!xt|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{xtn|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{xtd|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{mxt|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{!mxt|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{mxtn|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{mxtd|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{bxt|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{!bxt|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{bxtn|inline typeface change}} for comparison this is an inline typeface change for comparison
this is an {{bxtd|inline typeface change}} for comparison this is an inline typeface change for comparison

جستارهای‌وابسته

  • {{xt}} inline positive example text, in green, with serif font
  • {{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)
  • {{xt2}} same as {{xt}} but for blocks of text
  • {{!xt}} inline negative example text, in red, with serif font
  • {{!bxt}} same as {{!xt}} but uses boldface
  • {{!mxt}} same as {{!xt}} but uses mono-spaced font
  • {{!xt2}} same as {{!xt}} but for blocks
  • {{xtd}} inline deprecated (or uncertain, unavailable, lorem, etc.) example text, in grey
  • {{bxtd}} same as {{xtd}} but uses boldface
  • {{mxtd}} same as {{xtd}} but uses mono-spaced font
  • {{xtn}} inline neutral example text, with no color change, when none of the above applies
  • {{bxtn}} same as {{xtn}} but uses boldface; it still applies a CSS class, so it's not simply boldfacing
  • {{mxtn}} same as {{xtn}} but uses mono-spaced font; this is a good template to use when the shaded box formatting of <code>...</code> might be undesirable, or the semantics of it incorrect in the context
  • {{dc}} inline deprecated or deleted material; {{dc2}} variant has strikethrough (both explicitly use the <del> element); can be used in mainspace (articles), and where necessary wrapped in <code>, <samp>, or <kbd>