View source for Template:Infobox color/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Lua|Module:Color}}
{{Infobox color
|title      =Sample color
|hex        =0080FF
|bgcolor    =
|image      =Image:CIExy1931.png
|image_size =
|alt        =Some alt
|caption    =CIE colorspace
|frequency  =num - num
|wavelength =num - num
|symbolism  =Some symbols
|spelling   =Some spelling
|cmyk=1
|c=C|m=M|y=Y|k=K
|source=Sample color
|colorspace=Color Space
|isccname   =Some isc name
|caveat     =Some caveat
|variations=1
|variation1=Darker sample|variation1color=#003F7F
|variation2=Lighter sample|variation2color=#3FCFFF
}}

The sRGB triplet, HSV, CIELch<sub>uv</sub> and (if enabled) CMYK coordinates are automatically calculated from the hex parameter, so they generally do not need to be specified. CMYK is hidden by default because it doesn't take color profiles into account.

==Blank template==

Minimal usage:

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox color
|title  = 
|hex    =
|source =
}}
</syntaxhighlight>

Full usage:

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox color
|title      = 
|hex        =
|hexref     =
|source     =
|bgcolor    =
|image      =  
|image_size =
|alt        =
|caption    =
|frequency  =
|wavelength =
|symbolism  =
|spelling   =
|cmyk       = <!-- Set to 1 to display -->
|c=|m=|y=|k=  <!-- Give CMYK only when you know what you are doing -- see notes. -->
|cmykref    =
|colorspace =
|isccname   =
|caveat     =
|variations = 
|variation1 =|variation1color=
|variation2 =|variation2color=
|variation3 =|variation3color=
|variation4 =|variation4color=
|variation5 =|variation5color=
|variation6 =|variation6color=
|variation7 =|variation7color=
|variation8 =|variation8color=
}}
</syntaxhighlight>

==Parameters==
The following template parameters are supported:

{| class="wikitable"
! colspan="2" style="text-align: center;" | Recommended parameters
|-
! title 
| Name of the color
|-
! hex 
| sRGB hex triplet.
|-
! source 
| Source for the main color coordinates, usually an RGB triplet or an hex triplet, in [[sRGB]] space. See [[Wikipedia:WikiProject Color/Sources for Color Coordinates]].
|-
! colspan="2" style="text-align: center;" | [[Spectral color]] parameters (optional)
|-
! wavelength
| The [[wavelength]] interval in [[Nanometre|nm]].
|-
! frequency
| The [[frequency]] in [[Terahertz (unit)|THz]].
|-
! colspan="2" style="text-align: center;" |  Variation samples (optional)
|-
! variations 
| If set include some samples of variations.
|-
! variationstitle
| Used for the title of the variations section, otherwise "Some variations of title" is used.
|-
! variation''N''
| Name of the Nth variation, where N is between 1 and 8.
|-
! variation''N''color
| Color used for variationN, defaults to the web color of the same name.
|-
! colspan="2" style="text-align: center;" |  CMYK parameters (optional)
|-
! cmyk
| Enable display of CMYK coordinates. The coordinates are otherwise hidden (see [[:Category:Color articles with suppressed CMYK data]]).
|-
! c 
| Cyanic CMYK color space coordinate
|-
! m 
| Magenta CMYK color space coordinate
|-
! y 
| Yellow CMYK color space coordinate
|-
! k 
| Black CMYK color space coordinate
|-
! cmykref
| The reference for CMYK coordinates, if different from the main source.
|-
! colspan="2" style="text-align: center;" |  Other parameters
|-
! bgcolor
| (Optional) Color in hex format used for background behind the name of the color. Defaults to value specified by the hex parameter.
|-
! caption
| (Optional) Appears under image, if specified.
|-
! caveat 
| (Optional) Additional text to display at the bottom of the infobox.
|-
! colorspace 
| (Optional) Colorspace of this color.
|-
! image
| (Optional) Name of an image to display. Do not use wikicode: use the format <code>image=Image:Example.jpg</code>
|-
! isccname
| (Optional) Display ISCC–NBS System of Color Designation color category
|-
! spelling 
| (Optional) For articles standardised to the British spelling this can be set to "Colour". The word "colour" is case-insensitive.
|-
! symbolism
| What the color commonly represents. Multiple lines may be included using <nowiki><br></nowiki>
|}

==Notes==
===Color/Colour spelling===
For articles standardised to British spelling, add the parameter <code>spelling=Colour</code>. The word "colour" is case-insensitive.

===CMYK values===
There is no functionality for converting RGB to CMYK because there is no single CMYK color space. Variations in paper and ink processes account for the various combinations of non-invertible matrices and look-up tables used in converting from RGB to CMYK. If you wish to obtain CMYK values for these colors, you will get appropriate conversion values from your graphics application when you define the type of ink and paper you will be printing on.

A CMYK value is meaningful only if you can specify what ink&ndash;paper&ndash;process standard it is supposed to be used with. If your color article does not specifically concern a quirk in the CMYK process (such as [[rich black]]), it's best to leave it unspecified since it does not add additional information.

Because the CMYK data quality is generally awful, the infobox currently adds an additional barrier to its use, requiring a {{para|cmyk|1}} to be passed. Articles without this parameter but still providing a CMYK value are sorted into [[:Category:Color articles with suppressed CMYK data]]. An article should provide a CMYK coordinate with {{para|cmyk|1}} only when the source provides these coordinates.

==See also==
* [[:Category:WikiProject Color articles needing infobox sources]]
* [[:Category:Color articles with unsourced CMYK data]]

Simple colorbox templates to display a sample color:
{{Color box templates}}
{{Color shades}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Arts and culture infobox templates|Color]]
[[Category:Science and nature infobox templates|Color]]
[[Category:Color templates|Infobox]]
}}</includeonly>