Template:Tincture/doc

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Tincture.

العربية ∙ asturianu ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ euskara ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ हिन्दी ∙ hrvatski ∙ magyar ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ 한국어 ∙ кыргызча ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ ဘာသာ မန် ∙ Bahasa Melayu ∙ Mirandés ∙ မြန်မာဘာသာ ∙ norsk bokmål ∙ Plattdüütsch ∙ Nederlands ∙ norsk ∙ polski ∙ português ∙ português do Brasil ∙ русский ∙ sicilianu ∙ Scots ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ اردو ∙ oʻzbekcha ∙ Tiếng Việt ∙ 简体中文 ∙ 繁體中文 ∙ +/−

Redirect:

{{FIAV1}}

Uses Lua:

Module:Tincture

This template uses TemplateStyles:

Template:Tincture/styles.css

This template is used to display vexillological and heraldic colors, as used in flags and coats of arms.

Usage

This template can handle any mixture of the whole tincture names and their single-letter abbreviation codes.
The colors are provided each one with unnamed parameters, or all of them in the first unnamed parameter, separated by slashes.
The color sequence should be: first silver and gold, then the other color letters in alphabetic order. Usage: e.g. {{ Tincture | a | b | g | v }} or {{ Tincture | argent | azure | gules | vert }}, or {{ Tincture | a/b/g/v }} or {{ Tincture | argent/azure/gules/vert }}.
Only the slash-separated format can be used from {{COAInformation}} and {{File generation description}} e.g. |Tincture=a/b/g/v, and from {{Image generation}} |C=a/b/g/v.
Note: An empty parameter (e.g. 2 pipes or slashes) terminates the generation of the boxes and leaves the trailer an internal comment.

Template parameters

Parameter	Description		Default	Status
`1`	color 1	The first color to display, or all colors separated by / (slashes).	empty	required
`2`	color 2	The second color to display, and so on, any number of colors	empty	optional
`ss`	color shade	The color style to be used. Several special color shades are supported.	0	optional
`cm`	comment	Any text that should follow the boxes.	empty	optional
`pf`	postfix	possible postfixing of each box, e.g. `<br />` for vertical, or pipe(s) for table elements.	empty	optional
`align`	alignment	The alignment of the color boxes: “left”, “right” or “center”.	left	optional
`+`	Information field	“+” sign instead of a color code, or if the value is “+” (i.e. “\|+=+”), the output is wrapped in {{Information field}}.	empty	optional
`-`	cat suppression	“-” sign instead of a color code: avoids the (automatic or other) categorization to Coats of arms by tincture.	empty	optional
`ns`	namespace	“6” for treating files; not needed for COAInformation.	empty	optional
`cat`	categories	Override standard categorization. More details on categorization.	empty	optional

Additional information

The template is intended to be used in the following namespaces: no namespace specified

The template is intended to be used by the following user groups: no user group specified

Example

{{Tincture|a / o / b / g / p / s / v}}

renders as:

argentorazuregulespurpuresablevert

Colors

Each one of these colors can be specified by a one-letter short code (e.g. "A"), or by its standardized name (e.g. "argent-d").

Tooltip: The hexadecimal rgb color value is displayed when the cursor is moved over the colored field.

argent	a	`argent`
argent-d	A	`argent-d`	[“argent dark”]
or	o	`or`
azure	b	`azure`	[for “bleu” or “blue”]
céleste	B	`céleste`	[for “bleu-céleste”]
carnation	c	`carnation`
cendrée	C	`cendrée`
gules	g	`gules`
naranja	n	`naranja`
purpure	p	`purpure`
sable	s	`sable`
tenné	t	`tenné`
vert	v	`vert`
transparent	x	`invisible`	[no tincture] (transparent)

Other common tinctures like orange, sanguine, murrey, brunâtre are not yet supported.

But for test reasons it is also possible to use it with additional colors, instead of the color letter the hexadecimal color value can be used, e.g.

#abc	#abc	(note that the short color codes with 3 hex-digits was not working with the now obsolete Internet Explorer web browser!)
	#2F4D5A.	In the cases of hex color codes the parameter for text color, e.g. `tc=F0F`, allows to use a text color more different from the background color.

Any other parameter value causes maintenance categorization and an error message, e.g {{ Tincture | 32a }} gives the error message

Unknown tincture code: "32a"

Note :: The tincture nomination should always be: first argent and or, then all the other colors in alphabetic sequence:; a - A - o — b - B - c - C - g - n - p - s - t - v

Special color shades (palettes)

With {{COAInformation}}, use |tincture-ss= or |ss= as an addition to |tincture=, e.g. |tincture=a/b/g|ss=NW.
With {{File generation description}} use |Tincture-ss=, and with {{Image generation}} the parameter |ss= or |Css=.
In stand-alone usage, add the "ss" parameter: {{ Tincture | a | b | g | NW }}. In some shades, not all colors are defined.

In the stand-alone case it is also possible to define the special color shade with e.g. {{ Tincture | a | b | g | ss = NW }}, or shorter
with {{ Tincture | a/b/g/NW }} (code for the special color shade in upper case!), like a color code or the + or - at any position.

With the parameter ss=GN (or the parameter ss=0) (with the parameter ss=≈ it can be shown that the used colours do not match exactly the standard tinctures) or without this parameter, the generic tincture colors are shown: Tincture (GN)
InfoField
argentargent-dorazurecélestecarnationcendréegulesnaranjapurpuresabletennévert

With the parameter ss=FR the tincture colors of France are shown: Tincture (FR)
InfoField
argenttransparentorazurecélestecarnationcendréegulesnaranjapurpuresabletransparentvert

With the parameter ss=BW the tincture colors of Baden-Württemberg are shown: Tincture (BW)
InfoField
argenttransparentorazuretransparentcarnationtransparentgulestransparenttransparentsabletransparentvert

With the parameter ss=BY the slightly different Bavarian colors are shown: Tincture (BY)
InfoField
argentargent-dorazurecélestecarnationcendréegulestransparentpurpuresabletennévert

With the parameter ss=RP the slightly different Rhineland-Palatinate colors are shown: Tincture (RP)
InfoField
argentargent-dorazurecélestecarnationcendréegulestransparentpurpuresabletennévert

With the parameter ss=BB the tincture colors of Brandenburg are shown: Tincture (BB)
InfoField
argenttransparentorazurecélestetransparenttransparentgulestransparenttransparentsabletransparentvert

With the parameter ss=CH the tincture colors of Switzerland are shown: Tincture (CH)
InfoField
argenttransparentorazureazuretransparenttransparentgulestransparenttransparentsabletransparentvert with "light azure"

With the parameter ss=SF the tincture colors of the Swiss flags reglement are shown: Tincture (SF)
InfoField
argenttransparentorazuretransparenttransparenttransparentgulestransparenttransparentsabletransparentvert

With the parameter ss=AG the tincture colors of Kanton Aargau are shown: Tincture (AG)
InfoField
argenttransparentorazuretransparenttransparenttransparentgulestransparenttransparentsabletennévert

With the parameter ss=GR the tincture colors of Kanton Graubünden are shown: Tincture (GR)
InfoField
argenttransparentorazuretransparenttransparenttransparentgulestransparentpurpuresabletennévert

With the parameter ss=NW the tincture colors of Kanton Nidwalden are shown: Tincture (NW)
InfoField
argenttransparentorazuretransparenttransparenttransparentgulestransparenttransparentsabletennévert

With the parameter ss=UA the tincture colors of Upper Austria are shown: Tincture (UA)
InfoField
argenttransparentorazuretransparentcarnationcendréegulestransparenttransparentsabletennévert

With the parameter ss=HU the tincture colors of Hungary are shown: Tincture (HU)
InfoField
argentargent-dorazuretransparenttransparenttransparentgulestransparentpurpuresabletransparentvert

With the parameter ss=IT the tincture colors of Italy are shown: Tincture (IT)
InfoField
argentoargento-doroazzurrocielocarnagioneincolorerossoincoloreporporaneroincoloreverde

With the parameter ss=RU the tincture colors of Russia are shown: Tincture (RU)
InfoField
argenttransparentorazuretransparenttransparentcendréegulesnaranjapurpuresabletennévert

With the parameter ss=SK the tincture colors of Slovakia are shown: Tincture (SK)
InfoField
argenttransparentorazuretransparenttransparenttransparentgulestransparenttransparentsabletransparentvert

With the parameter ss=SV the tincture colors of Sweden are shown: Tincture (SV)
InfoField
argenttransparentorazurecélestecarnationtransparentgulestransparentpurpuresabletransparentvert

With the parameter ss=NS ("NS" for "non standard") all other colors can be mentioned (not shown): Tincture (NS)
InfoField
argentargent-dorazurecélestecarnationcendréegulesnaranjapurpuresabletennévert

See also Template talk:Tincture/box or Commons talk:All tincture variations for another illustration.

When a color combination contains a color that cannot be expressed with above tinctures, with ColorString such colors can be shown:

{{ ColorString | /B/#069/#396/#900/#333/#666/#999 }} will give:
#069#396#900#333#666#999,
{{ ColorString | /D/#069/wmb/#396/#396 /#900/wmr/wm3/#333 }} will give:
wmb#396wmr#333.

{{ Tincture | brunâtre/murrey/sanguine }} will give
brunâtremurreysanguine
{{ Tincture | e/V/m }} will give

Categorization

Automatic categorization is performed by the subtemplates {{Tincture/cat0}}.
Any other (tincture-) category or categories may be defined with the parameter cat=; specified either complete with the brackets: cat=[[Category:...]] or only the name (without brackets and "Category:").

While colours may be expressed by codes or by full names, automatic categorization is only possible when the one-letter-codes are used.

To suppress any categorizing set either “cat=”, “cat=-” or set the “-” with SS= or like a color code, at any position.
To put into Tinctures uncategorizeable, use "?" like a color code, at any position.
To force categorization "*" can be used like a color code, at any position.
Otherwise automatic categorization occurs, when possible.

Precedence

When contradicting parameters are set:

The "-" (don't categorize) suppresses every categorization
The "?" (categories unable) ignores the "force cat" parameter
The "*" (force categorization) categorizes otherwise,
The automatic categorization may occur when no other parameter is used.

Information field

An internationalized field name is generated, when required by specifying “+=+”;

when tinctures are set with COAInformation, this is done by default;
when tinctures are set with Image generation, this is done by default (but can be suppressed with “Cf=-”).
The “+” for the field name can also be set as simple “+” like the “-” like a color code, at any position.

See also Color boxes.

GPL palettes

Image editing applications such as Inkscape and GIMP support image swatch files known as GIMP-Palettes, which can be imported to and exported from these applications.

The Commons:Colour palettes can be used to create copy&paste-able data from all the tincture variations shown above, and to have these valid colours for usage wihin the tools.

A complete instruction how to generate such palettes can be found in Commons talk:Colour palettes.

To use the template:Tincture for table creation, the parameter |gpltab= can be used:

gpltab=1 default value, is automatically set to tincturize files
gpltab=2 value to generate tables
gpltab=3 value to do both, is automatically set on that page

Because this parameter needs never to be set, except for test cases, it is not described above.

A complete set of instructions on how to generate such palettes can be found in Commons talk:Colour palettes; it contains also some hints how to add new colour variations.

Template:Tincture/doc

Contents