View source for Template:ColorString

<includeonly>{{#invoke:Color2dec|cstring|}}</includeonly><noinclude>
{{Lua|Module:Iteration|Module:Color2dec}} This template creates one or more color boxes followed by a text string  which may contain also wikilinks.

It is also possible to let it create a field name, when used within <code>|other fields 1</code> or <code>|other fields</code>.

The template has either <u>'''only one''' unnamed parameter</u>, a string of possible subparameters separated by slashes,
<br>or unnamed parameters separated by pipes; ''in both cases an <u>unlimited number</u> of (sub)parameters can be specified.''
;Subparameters:
are either pairs of colorcode and text, or just the colorcodes. Each valid color code ([[Template talk:ColorString|CSS color names]], hex triplet, {{T0|tincture|tincture names}}) can be used.<br>
The text can be also wiki-formatted, e.g. a link.<br>
In any case, a pair of control codes ''may'' precede the string; they are also slash/pipe-separated, e.g. "<code>-/-</code>".<br>
The first code may be (see {{T0|Igen/cbox}})
* "<tt>-</tt>" or missing: default;
* "<tt>+</tt>" requesting the generation of a {{T0|InFi|field name}}
* "<tt>e</tt>" <small>''only when the second code is "T"'': an "e" will display a bordered example of the file</small>
The second code specifies 
* a "<tt> </tt>" or missing for {{T|Legend}} or {{T|Legtab}} with parameter pairs, 
* a "<tt>C</tt>" for {{T|Legend}} ''but Text "Colors"'' with parameter pairs, 
* a "<tt>D</tt>" for {{T|ColorBox}} with (tincture) parameter pairs, 
* a "<tt>M</tt>" or  "<tt>-</tt>" for {{T|Legend-small}} with parameter pairs, 
* a "<tt>T</tt>" for {{T|Tbc|+|case=l}} always with parameter pairs,
* a "<tt>B</tt>" for {{T|ColorBox}} with '''''single''' parameter values'' {{0|WWWWWW}} '''"B"''' is usable for non-standard tinctures 
* a "<tt>L</tt>" for {{T|Legend}} with '''''single''' parameter values'', ¹)
* a "<tt>S</tt>" for {{T|Legend-small}} with '''''single''' parameter values''.
:¹) <small>the "L" possibility exists just for completion – normally a "Legend" without an explaining second value will not be useful.</small>
<div style="background-color:#cfc;width:55%;">When parameter lists of pairs ("", "<tt> </tt>", "<tt>C</tt>", "<tt>D</tt>", "<tt>-</tt>", "<tt>M</tt>", "<tt>T</tt>") should contain an URL address<br>in the second parameter, that is only possible with a parameter list separated by pipes "|".<br>
Otherwise the slashes in the URL address would disturb a slash-separated parameter list.</div>
Whenever possible, the boxes are ''{{W|tooltip}}ped''.

== Examples ==
See [[Template talk:ColorString|there]] an example with many colors. 
See [[Template:Tbc/doc#Colorstring|there]] <!-- two --> examples for {{T0|Tbc}} parametrizing. 

{| class="wikitable" style="align:left"
!This parameter string... !! ...yields:
|-
| <code><nowiki>#FF0</nowiki></code>
| {{ColorString|#FF0}}
|-
| <code><nowiki>/B/vert/#396</nowiki></code>
| {{ColorString|/B/vert/#396}}
|-
| <code><nowiki>/D/#BC3F4A/sanguine</nowiki></code>
| {{ColorString|/D/#BC3F4A/sanguine}}
|-
| <pre>
 lime/{{W|green}}
/#0f47af/azure
/#DA121A/gules
/#999/{{Wf|cendrée}}</pre>
| {{legtab|
  lime/{{W|green}}
/#0f47af/azure
/#DA121A/gules
/#999/{{Wf|cendrée}}}}
|-
| with hex codes (and pipes):<br><br><code><nowiki>-|S|#000|#00f|#F0F|#396</nowiki></code>
| {{ColorString|-|S|#000|#00f|#F0F|#396}}
|-
|  with the (full!) tincture names:<br><br><pre>
argent//argent-d//or//
azure//carnation//céleste//
cendrée//gules//purpure//
sable//tawny//vert</pre>
| {{ColorString|//argent//argent-d//or//azure//carnation//céleste//cendrée//gules//purpure//sable//tawny//vert}}
|-
|-
| with exotic tincture names<br><pre>
 /L/brunâtre/murrey/
 orange_t/sanguine</pre> 
|{{ColorString|/L/brunâtre/murrey/orange_t/sanguine}}
|-
|  with the CSS color names:<br><br><pre>/S/black/silver/maroon/red/
green/lime/olive/yellow/
navy/blue/purple/fuchsia/
teal/aqua/gray/olivedrab/
azure_CSS</pre>
|{{ColorString|/S/black/silver/maroon/red/green/lime/olive/yellow/navy/blue/purple/fuchsia/teal/aqua/gray/olivedrab/azure_CSS/}}
|-
|  with URL addresses and other links<br><pre>|M|Peru|{{W|Peru}}|plum|{{Plainlinks|
https://en.wikipedia.org/wiki/Plum|
URL1}}|crimson}}</pre>
|{{ColorString||M|Peru|{{W|Peru}}|plum|{{Plainlinks|https://en.wikipedia.org/wiki/Plum|URL1}}|crimson}}
|}
[[Category:Colorbox formatting templates| ]]
[[Category:Color text formatting templates| ]]
</noinclude>