Difference between revisions of "Template:Font color/doc"

From blackwiki
Jump to navigation Jump to search
imported>Eyesnore
m (Reverted edits by 66.87.134.126 (talk) (HG) (3.1.21))
imported>Crissov
(see also: {{tl|coltit}} — colored table header cell)
 
(18 intermediate revisions by 15 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
{{Warning|1={{big|'''Links should clearly be identifiable as links to readers'''.}}<br />Refrain from implementing colored links that may impede user ability to distinguish links from regular text, or color links for purely aesthetic reasons. See the guides to editing articles for accessibility at  [[WP:CONTRAST|contrast]], [[ Wikipedia:Manual of Style/Accessibility|accessibility]] and [[WP:NAVBOXCOLOUR|navbox colors]].}}
 
{{Warning|1={{big|'''Links should clearly be identifiable as links to readers'''.}}<br />Refrain from implementing colored links that may impede user ability to distinguish links from regular text, or color links for purely aesthetic reasons. See the guides to editing articles for accessibility at  [[WP:CONTRAST|contrast]], [[ Wikipedia:Manual of Style/Accessibility|accessibility]] and [[WP:NAVBOXCOLOUR|navbox colors]].}}
<includeonly>{{High-use|14,000+}}</includeonly>
+
{{High-use| 90150 }}
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
  
Line 17: Line 17:
 
to something other than blue for when you need to work within background colors.  
 
to something other than blue for when you need to work within background colors.  
 
Normally <kbd>[<nowiki/>[ wikilink ]]</kbd> &rarr; [[wikilink]],  
 
Normally <kbd>[<nowiki/>[ wikilink ]]</kbd> &rarr; [[wikilink]],  
but but here we use a {{tl | font color }} with {{para | link }} to create a black wikilink &rarr;  
+
but here we use a {{tl | font color }} with {{para | link }} to create a black wikilink &rarr;  
 
{{ font color | black | violet | link=yes | &nbsp;&nbsp;&nbsp;wikilink&nbsp;&nbsp;&nbsp; }}
 
{{ font color | black | violet | link=yes | &nbsp;&nbsp;&nbsp;wikilink&nbsp;&nbsp;&nbsp; }}
 
You can make any text link to any page using the {{para|link}} parameter.
 
You can make any text link to any page using the {{para|link}} parameter.
  
This template will use the latest [[Wikipedia:HTML5]] recommendations,  
+
This template will use [[Wikipedia:HTML5]] recommendations,  
 
inserting the span tags
 
inserting the span tags
{{tag|span|params=style=color:''color''}} and
+
{{tag|span|params=style="color:''color''"}} and
{{tag|span|params=style=background-color:''color''}} for you, so your page increases its readability and usability in both the wikitext and the rendered page.
+
{{tag|span|params=style="background-color:''color''"}}, so the page increases its readability and usability in both the wikitext and the rendered page.
  
 
== Usage ==
 
== Usage ==
Line 85: Line 85:
 
  | <code><nowiki>{{ font color | blue | do not style text as a link }}</nowiki></code>
 
  | <code><nowiki>{{ font color | blue | do not style text as a link }}</nowiki></code>
 
  | {{ font color | blue | do not style text as a link }}
 
  | {{ font color | blue | do not style text as a link }}
|-
 
| <code><nowiki>{{ font color | white | black | white with black background }}</nowiki></code>
 
| {{ font color | white | black | white with black background }}
 
 
|-
 
|-
 
  |  | <code>{<nowiki/>{ font color'''{{big | {{! }}<nowiki/>{{! }} }}'''yellow | default text in yellow background }}</code>
 
  |  | <code>{<nowiki/>{ font color'''{{big | {{! }}<nowiki/>{{! }} }}'''yellow | default text in yellow background }}</code>
Line 94: Line 91:
 
  |  | <code>{<nowiki/>{ font color'''{{big | {{! }} }}'''bg=yellow | text = default text in yellow background }}</code>
 
  |  | <code>{<nowiki/>{ font color'''{{big | {{! }} }}'''bg=yellow | text = default text in yellow background }}</code>
 
  | {{ font color | bg=yellow | text = default text in yellow background }}
 
  | {{ font color | bg=yellow | text = default text in yellow background }}
 +
|-
 +
| <code><nowiki>{{ font color | white | black | white with black background }}</nowiki></code>
 +
| {{ font color | white | black | white with black background }}
 +
|-
 +
| <code><nowiki>{{ font color | #ffffff | #000000 | white with black background }} ([[hexadecimal colors]]) </nowiki></code>
 +
| {{ font color | #ffffff | #000000 | white with black background}} ([[hexadecimal colors]])
 
|}
 
|}
  
Line 100: Line 103:
 
!Renders as
 
!Renders as
 
|-
 
|-
  | <code><nowiki>{{ font color | white | blue | Wikipedia:Example | link = yes }}</nowiki></code></code>
+
  | <code><nowiki>{{ font color | white | blue | Wikipedia:Example | link = yes }}</nowiki></code>
 
  | {{ font color | white | blue | Wikipedia:Example | link = yes }}
 
  | {{ font color | white | blue | Wikipedia:Example | link = yes }}
 
|-
 
|-
Line 115: Line 118:
  
 
Although a wikilink accepts a ''font color'' (or other template or markup):
 
Although a wikilink accepts a ''font color'' (or other template or markup):
:<code>{{big|[<nowiki/>[}}Wikipedia:Example{{big|{{!}}}}{<nowiki />{font color|white|blue|the Wikipedia:Example page}}{{big|]]}}</code>  
+
:<code>{{big|[<nowiki/>[}}Wikipedia:Example{{big|{{!}}}}{<nowiki />{font color|white|blue|the Wikipedia:Example page}}{{big|]]}}</code>
:&rarr; [[Wikipedia:Example | {{ font color | white | blue | the Wikipedia:Example page}}]] (a font-colored link),
+
:[[Wikipedia:Example | {{ font color | white | blue | the Wikipedia:Example page}}]] (a font-colored link),
 
a ''font color'' does not accept a wikilink, it creates wikilinks itself with {{para|link}}.
 
a ''font color'' does not accept a wikilink, it creates wikilinks itself with {{para|link}}.
*{{OK }} {<nowiki/>{ font color | green | violet | Wikipedia:Example | link=yes }} &rarr; {{ font color | green | violet | Wikipedia:Example | link=yes }} (a {{para|link}} {{tl | font color }})
+
*{{OK }} {<nowiki/>{ font color | green | violet | Wikipedia:Example | link=yes }} {{ font color | green | violet | Wikipedia:Example | link=yes }} (a {{para|link}} {{tl | font color }})
*{{cross }}{<nowiki/>{ font color | green | violet | the [<nowiki/>[Wikipedia:Example]] page}} &rarr; {{ font color | green | violet | the [[Wikipedia:Example]] page }} (Text with [<nowiki/>[wikilink brackets]] overrides the designated color)
+
*{{cross }}{<nowiki/>{ font color | green | violet | the [<nowiki/>[Wikipedia:Example]] page}} {{ font color | green | violet | the [[Wikipedia:Example]] page }} (Text with [<nowiki/>[wikilink brackets]] overrides the designated color)
*{{cross }}{<nowiki/>{ font color | green | violet | [<nowiki/>[Wikipedia:Exammple]] }} &rarr; {{ font color | green | violet | the [[Wikipedia:Exammple]] page }} (Text with [<nowiki/>[wikilink brackets]] overrides the designated color)
+
*{{cross }}{<nowiki/>{ font color | green | violet | [<nowiki/>[Wikipedia:Exammple]] }} {{ font color | green | violet | the [[Wikipedia:Exammple]] page }} (Text with [<nowiki/>[wikilink brackets]] overrides the designated color)
 
<!--
 
<!--
  
 
--><includeonly>For more examples see [[/testcases]].</includeonly>
 
--><includeonly>For more examples see [[/testcases]].</includeonly>
For actual mainspace template usage, here are search links for  
+
For actual mainspace template usage, here are search links for
 
* {{sl | hastemplate:"font color" | label=all usage }}.
 
* {{sl | hastemplate:"font color" | label=all usage }}.
 
* {{template usage | font color | pattern=link= | prefix=: | label=where <code>{{! }}link=</code> is used }}.
 
* {{template usage | font color | pattern=link= | prefix=: | label=where <code>{{! }}link=</code> is used }}.
Line 137: Line 140:
 
* {{tl|color}}
 
* {{tl|color}}
 
* {{tl|background color}}
 
* {{tl|background color}}
 +
* {{tl|coltit}} — colored table header cell
 
* {{tl|color contrast ratio}}
 
* {{tl|color contrast ratio}}
 
* {{tl|hilite}}
 
* {{tl|hilite}}
Line 142: Line 146:
 
* {{tl|tq}}
 
* {{tl|tq}}
 
* {{tl|xt}}
 
* {{tl|xt}}
<includeonly>
+
 
 +
<includeonly>{{sandbox other||
 
<!-- categories -->
 
<!-- categories -->
 
[[Category:Text color templates]]
 
[[Category:Text color templates]]
 +
}}
 
</includeonly>
 
</includeonly>

Latest revision as of 07:36, 27 February 2020

Purpose

{{ Font color }} is how you insert colorized text, such as red, orange, green, blue and indigo, and many others. You can specify its background color at the same time.

{{ Font color }} is also how you can color wikilinks to something other than blue for when you need to work within background colors. Normally [[ wikilink ]]wikilink, but here we use a {{ font color }} with |link = to create a black wikilink →    wikilink    You can make any text link to any page using the |link= parameter.

This template will use Wikipedia:HTML5 recommendations, inserting the span tags <span style="color:color">...</span> and <span style="background-color:color">...</span>, so the page increases its readability and usability in both the wikitext and the rendered page.

Usage

{{Font color}} has a one-color and a two-color form:

{{font color | color | text }}
{{font color | text color | background color | text }}.

Either form has a |link= option, for colorizing (otherwise blue or red) wikilink text.

|link=yes[[text]]
|link=fullpagename[[fullpagename]]

You can also name the other fields.

{{font color | fg=color | text=text }}
{{font color | fg=text color | bg=background color | text=text }}

You can name |fg= or |bg=, which is nice, but... if you name either of them, you must also name |text=, which is a compromise. (See Help:Template#Parameters for why.)

Spacing is of no concern.

.{{font color|tan|green|text with four words}}..text with four words.
. {{font color|tan|green|text with four words}} .. text with four words .
. {{ font color | tan | green | text with four words }} .. text with four words .

Parameters

Script error: No such module "aligned table".

Or

Script error: No such module "aligned table".

Examples

Markup Renders as
{{ font color | green | green text }} green text
{{ font color | blue | do not style text as a link }} do not style text as a link
{{ font color || yellow | default text in yellow background }} default text in yellow background
{{ font color | bg=yellow | text = default text in yellow background }} default text in yellow background
{{ font color | white | black | white with black background }} white with black background
{{ font color | #ffffff | #000000 | white with black background }} ([[hexadecimal colors]]) white with black background (hexadecimal colors)
Markup Renders as
{{ font color | white | blue | Wikipedia:Example | link = yes }} Wikipedia:Example
{{ font color | white | blue | Wikipedia:Example | link = Wikipedia:Sandbox }} Wikipedia:Example
{{ font color | text = Wikipedia:Example | link = Wikipedia:Sandbox | bg = blue | fg = white }} Wikipedia:Example

The |link= parameter is a good way to colorize wikilinks, and it is about as much typing as the pipe trick.

Although a wikilink accepts a font color (or other template or markup):

[[Wikipedia:Example|{{font color|white|blue|the Wikipedia:Example page}}]]
the Wikipedia:Example page (a font-colored link),

a font color does not accept a wikilink, it creates wikilinks itself with |link=.

  1. REDIRECT Template:Xmark

{{ font color | green | violet | the [[Wikipedia:Example]] page}} → the Wikipedia:Example page (Text with [[wikilink brackets]] overrides the designated color)

  1. REDIRECT Template:Xmark

{{ font color | green | violet | [[Wikipedia:Exammple]] }} → the Wikipedia:Exammple page (Text with [[wikilink brackets]] overrides the designated color)

For actual mainspace template usage, here are search links for

See also