Template:Xt/doc: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
meta>Greg L
m color: various tweaks for syntax and font color control and punctuation
Ookami (talk | contribs)
m 95 revisions imported
 
(84 intermediate revisions by 37 users not shown)
Line 1: Line 1:
{{Documentation subpage}}
{{Documentation subpage|[[Template:xt]], [[Template:bxt]], [[Template:mxt]], [[Template:xtd]], [[Template:bxtd]], [[Template:!xt]], [[Template:!bxt]], and [[Template:!mxt]]}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{#ifeq:{{PAGENAME}}|!xt|{{used in system|in [[MediaWiki:Emailpagetext]]}}}}
{{#ifeq:{{PAGENAME}}|Xt|{{lowercase title}}}}
<!--PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE-->
{{distinguish|Category:Text color templates}}
==Using example-formatting templates in general==
{{mbox
| type      = content
| small = yes
| text      = This family of templates ''cannot'' be used in [[Wikipedia:Mainspace|mainspace]] (the article [[Wikipedia:Namespace|namespace]]).
}}
The [[:Category:Example-formatting templates|category of example-formatting templates]] is used frequently in non-[[Wikipedia:Mainspace|mainspace]] general help pages such as [[Wikipedia:Manual of Style|Wikipedia:Manual of Style (MOS)]] when ''inline'' typeface changes are needed.


=== Usage ===
{{strong|This family of templates ''cannot'' be used in mainspace (the article [[Wikipedia:Namespace|namespace]]).}}
Use this template to format style examples (for example, on the [[Wikipedia:Manual of Style|Manual of Style]] and its subpages), especially when using quotation marks or italics could be confusing. (Use <code>1=</code> before the argument if it contains equals signs.)


{|class="wikitable"
{{strong|Also, this family of templates is ''not'' for use as [[Help:Wikitext|wikitext markup]] for [[Wikipedia:Quotations|quotations]] on [[Wikipedia:Talk pages|talk pages]]}}; use {{tlx|tq}} instead.
|+Examples
 
For cases where the serif typeface is not desirable (e.g. in blocks of computer code), use {{tlx|bxt}}, which substitutes boldfacing, or {{tlx|mxt}}, which substitutes a mono-spaced font. For style examples that break to their own line (e.g. paragraphs), use {{tlx|xt2}}. 
 
For examples of {{!xt|bad/wrong style, in red}}, use {{tlx|!xt}}, {{tlx|!bxt}}, {{tlx|!mxt}}, or {{tlx|!xt2}}, respectively.
 
The {{tlx|xtd}} template exists for {{xtg|deprecated}} examples. Its alias {{tlx|xtg}} (for "grey") can be used to indicate uncertain, unavailable, disabled, lorem, etc., examples without implying [[deprecation]]. The bold, sans-serif equivalent is {{tlx|bxtd}} (and {{tlx|bxtg}} alias). The mono-spaced equivalent is {{tlx|mxtd}}.
 
The {{tlx|xtn}} template is for {{xtn|neutral}} examples, and has no color change, but is otherwise identical to {{tlx|xt}}. It can be used with {{tnull|xt}} and {{tnull|!xt}} to indicate usage that is neither advised nor advised against or deprecated. The bold, sans-serif equivalent is {{tlx|bxtn}}.
 
==Parameters==
 
* {{para||{{var|text here}}}} or {{para|1|{{var|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 {{para|1}} or the template will break.
* {{para|title|{{var|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 mono-spaced type style (as in {{xt|example text}}) is to make it fully accessible for those with [[color blindness]].
 
Keep [[WP:Accessibility|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 {{tlx|xt}} syntax and result==
 
;What you write:
 
:<code><nowiki>...for example, {{xt|1=''T''&nbsp;=&nbsp;293.15&nbsp;K}}, but not {{!xt|1=''m''=5.4kg}}.</nowiki></code>
 
;What you get:
 
:...for example, {{xt|1=''T''&nbsp;=&nbsp;293.15&nbsp;K}}, but not {{!xt|1=''m''=5.4kg}}.
 
{| class=wikitable
!What you type
!What you get
|-
|<kbd><nowiki>this is an {{</nowiki>'''xt'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{xt|inline typeface change}} for comparison
|-
|<kbd><nowiki>this is an {{</nowiki>'''!xt'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{!xt|inline typeface change}} for comparison
|-
|<kbd><nowiki>this is an {{</nowiki>'''xtn'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{xtn|inline typeface change}} for comparison
|-
|-
|<center>'''What you write'''</center>
|<kbd><nowiki>this is an {{</nowiki>'''xtd'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{xtd|inline typeface change}} for comparison
|-
|-
|<code><nowiki>Symbols for variables are normally italicized, and symbols for units of measurement are usually upright: for example, {{xt|1=''T''&nbsp;=&nbsp;293.15 K}}, {{xt|1=''m''&nbsp;=&nbsp;5.4&nbsp;kg}}.
|<kbd><nowiki>this is an {{</nowiki>'''mxt'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
</nowiki></code>
|this is an {{mxt|inline typeface change}} for comparison
|-
|-
|<code><nowiki>For nested quotations, use double quotes for the outermost level, single quotes for the next inner level, and continue alternating: for example, {{xt|The Dalai Lama stated in his book ''The Universe in a Single Atom'': "I am told that one of the greatest of all quantum theorists, Richard Feynman, wrote 'I think I can safely say that nobody understands quantum mechanics', so at least I feel I am in good company."}}</nowiki></code>
|<kbd><nowiki>this is an {{</nowiki>'''!mxt'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{!mxt|inline typeface change}} for comparison
|-
|-
|<center>'''What you get'''</center>
|<kbd><nowiki>this is an {{</nowiki>'''mxtn'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{mxtn|inline typeface change}} for comparison
|-
|-
|Symbols for variables are normally italicized, and symbols for units of measurement are usually upright: for example, {{xt|1=''T''&nbsp;=&nbsp;293.15 K}}, {{xt|1=''m''&nbsp;=&nbsp;5.4&nbsp;kg}}.
|<kbd><nowiki>this is an {{</nowiki>'''mxtd'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{mxtd|inline typeface change}} for comparison
|-
|-
|For nested quotations, use double quotes for the outermost level, single quotes for the next inner level, and continue alternating: for example, {{xt|The Dalai Lama stated in his book ''The Universe in a Single Atom'': "I am told that one of the greatest of all quantum theorists, Richard Feynman, wrote 'I think I can safely say that nobody understands quantum mechanics', so at least I feel I am in good company."}}
|<kbd><nowiki>this is an {{</nowiki>'''bxt'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{bxt|inline typeface change}} for comparison
|-
|-
|<center>'''About color and color blindness'''</center>
|<kbd><nowiki>this is an {{</nowiki>'''!bxt'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{!bxt|inline typeface change}} for comparison
|-
|-
|The accompanying change in typeface to a serif typestyle, ({{xt|example text}}) is to make it fully accessible for those with red/green color blindness. Actually, the change in typeface works for those with ''total'' color blindness, which makes it more accessible than the <font color="#002BB8">blue text</font color> that Wikipedia uses as the only clue that something is a link. The important point to remember about color blindness and accessibility is that editors must not use color ''alone''—especially red and/or green—to convey an important distinction, like <font color = green>“this is good”</font color> but <font color = red>“this is bad”</font color> or “<font color = maroon>GOOD</font color>/BAD”. This is prohibited under Wikipedia policy.<p>Color simply provides yet another way to distinguish example text for normal-sighted individuals. This is similar to the [http://www.sks-science.com/plastic-laboratory-bottles-p-967.html chemistry wash bottles] found in wet labs: the isopropanol wash bottle has a <font color="#002BB8">blue top</font color>, ethanol&nbsp;=&nbsp;<font color = orange>orange top</font color>, methanol&nbsp;=&nbsp;<font color = green>green top</font color>, acetone&nbsp;=&nbsp;<font color = red>red top</font color>. There is a big difference between acetone and methanol (red/green). If one is color blind, you read the wording on the bottle. If you have normal color vision, you have both indicators, where color is the quicker one. It’s the same for cylinders of compressed hydrogen; they come in red cylinders. Oxygen ('''<u>big</u>''' difference) cylinders are green. Of course, both are labeled with their contents too. Color is simply assistive; same here.
|<kbd><nowiki>this is an {{</nowiki>'''bxtn'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{bxtn|inline typeface change}} for comparison
|-
|<kbd><nowiki>this is an {{</nowiki>'''bxtd'''<nowiki>|inline typeface change}} for comparison</nowiki></kbd>
|this is an {{bxtd|inline typeface change}} for comparison
|}
|}
<includeonly>
<!-- CATEGORIES AND INTERWIKIS BELOW THIS LINE PLEASE -->


</includeonly>
== User CSS for a monospaced coding font ==
{{collapse top|left=y|title=Have monospaced templates in this group – and your editing window – use your preferred monospaced font:}}
{{Mxt/User CSS for a monospaced coding font}}
{{collapse bottom}}
 
==See also==
{{Xt/see also}}
 
<includeonly>{{Sandbox other||
<!--CATEGORIES AND INTERWIKIS BELOW THIS LINE PLEASE-->
[[Category:Example-formatting templates]]
[[Category:Text color templates]]
 
}}</includeonly>

Latest revision as of 14:13, 3 September 2020


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 family of templates cannot be used in mainspace (the article namespace).

Also, this family of templates is not for use as wikitext markup for quotations on talk pages; use {{tq}} instead.

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}}.

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 mono-spaced 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.
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

User CSS for a monospaced coding font

Have monospaced templates in this group – and your editing window – use your preferred monospaced font:

You can consistently use a monospaced font with well-designed characters for coding (e.g., to distinguish clearly between l, 1, and I, and between O and 0).

Add something like one of the code snippets below into your Special:MyPage/common.css page, replacing "Roboto Mono" with whatever your preferred coding font is (Roboto Mono was picked as a freely-available coding font for this example).

If you don't want to manually add this code to your CSS page but would rather @import (transclude) it, see meta:User:SMcCandlish/codefont.css for quick instructions.

This code will do the following:

  • Apply a consistent monospace font of your choice (and the fallback system-default monospace, should that font go missing or not have characters you need) to all the normally monospaced HTML elements like <code>, <pre>, etc.
  • Do the same for the classes used by {{mxt}} and other monospaced templates in the {{xt}} family
  • Do the same for additional site-wide classes (as 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 you know of an additional class to add here, please update this page or mention it on the talk page.

Horizontal style <syntaxhighlight lang="css">/* 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 */

  1. wpTextbox1, #wpSummary, #searchInput, #searchText { font-family: "Roboto Mono", monospace !important; }</syntaxhighlight>

Vertical style <syntaxhighlight lang="css">/* 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 */

  1. wpTextbox1,
  2. wpSummary,
  3. searchInput,
  4. searchText {
 font-family: "Roboto Mono", monospace !important;

}</syntaxhighlight>

Cleanup efforts

If you'd like to help clean up instances of the <tt>...</tt> element – which has not been valid HTML since the 1990s, and should usually be replaced with <code>...</code> (this may vary by context) – you can add something like the following to your common.css to make <tt> stick out like a sore thumb:

<syntaxhighlight lang="css">/* Flag bad code for cleanup */ tt { color: DarkRed; background: Pink; }</syntaxhighlight>

You can also do this with <font>, <center>, <strike>, and other deprecated elements. For CSS you can just import for this, see meta:User:SMcCandlish/lint.css.

See also

  • {{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 negative example text, 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 boldface
  • {{!mxt}} same as {{!xt}} but uses mono-spaced font; 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
  • {{dcr}} inline strongly deprecated or deleted material; {{dc2}} variant has strikethrough (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>)
     
  • {{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
  • {{dc}} inline deprecated or deleted material; (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>)
     
  • {{xtn}} inline neutral example text, with no color change, when none of the above applies; used for "permissible" examples neither favored nor deprecated
  • {{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 is incorrect in the context
     
  • {{strongbad}} – for introducing something as deprecated or issuing some other warning in documentation, e.g.: {{strongbad|Not for use in mainspace.}}