Template:Chset-color-undef/doc

This is a documentation subpage for Template:Chset-color-undef
It contains usage information, categories and other content that is not part of the original template page.

Usage edit

Used with Template:chset-tableformat data rows to indicate a color for undefined character code cells.

For example, the following ISO/IEC 646 character codes have regionally variant glyphs, and therefore are coded as rows in a character set table like this:

|{{chset-color-undef}}|{{chset-cell3|007B| |123}}
|{{chset-color-undef}}|{{chset-cell3|007C| |124}}
|{{chset-color-undef}}|{{chset-cell3|007D| |125}}
|{{chset-color-undef}}|{{chset-cell3|007E| |126}}

Similarly, the ISO C0 and C1 control codes are not part of the formal definition of the ISO/EIC character sets, so they should be coded as entirely blank cells within those character set tables:

|{{chset-color-undef}}|&nbsp;
|{{chset-color-undef}}|&nbsp;
|{{chset-color-undef}}|&nbsp;
|{{chset-color-undef}}|&nbsp;

Chset family of templates edit

See ISO 8859-1, Windows-1252, and EBCDIC for examples of usage.

Header and footer rows edit

Template:chset-table-header — Header and title row for a 16 column character set table
Template:chset-table-footer — Footer row for a 16 column character set table

Character row header edit

Template:chset-left — Left row code header

Character cell colors edit

Template:chset-color-letter — Letter (alphabetic, syllabic or logographic) character cell color (Unicode category L)
Template:chset-color-digit — Number character cell color (Unicode category N)
Template:chset-color-graph — Symbol character cell color (Unicode category S)
Template:chset-color-punct — Punctuation character cell color (Unicode category P)
Template:chset-color-undef — Undefined/unassigned character cell color
Template:chset-color-misc — Combining, whitespace or end-user defined character cell color (Unicode category M, Z, Co)
Template:chset-color-ctrl — Control character cell color (Unicode category Cc, Cf). Currently treated the same as misc.
Template:chset-color-esc — Lead byte in a multi-byte encoding (not a complete character).

For generating colours for cells by Unicode category, this script may be helpful.

Certain colours are in the process of being phased out:

Template:chset-color-ext-punct — Extended punctuation character cell color. Intended to represent non-ASCII punctuation, this is not a category used by Unicode (and there are no corresponding ext-digit, ext-graph etc). Currently renders the same as punct.

In addition to these, boxed and slightly shaded variants of these exist in order to indicate some kind of additional information (depending on the article) like, for example, a derivation from a base codepage, a variance of definition of the corresponding codepage in different sources (to be explained in the article) or in different revisions of a code page:

Template:chset-color-letter-box — Boxed letter character cell color
Template:chset-color-digit-box — Boxed number character cell color
Template:chset-color-graph-box — Boxed symbol character cell color
Template:chset-color-punct-box — Boxed punctuation character cell color
Template:chset-color-undef-box — Boxed undefined/unassigned character cell color
Template:chset-color-misc-box — Boxed combining, whitespace or end-user defined character cell color
Template:chset-color-ctrl-box — Boxed control character cell color
Template:chset-color-esc-box — Boxed lead byte cell color
Template:chset-color-ext-punct-box exists, but see the note above.

and

Template:chset-color-letter-var — Shaded letter character cell color
Template:chset-color-digit-var — Shaded number character cell color
Template:chset-color-graph-var — Shaded symbol character cell color
Template:chset-color-punct-var — Shaded punctuation character cell color
Template:chset-color-undef-var — Shaded undefined/unassigned character cell color
Template:chset-color-misc-var — Shaded combining, whitespace or end-user defined character cell color
Template:chset-color-ctrl-var — Shaded control character cell color
Template:chset-color-esc-var — Shaded lead byte cell color
Template:chset-color-ext-punct-var exists, but see the note above

Please note that the boxed variants must not be used, if a cell, which is not to be marked, is surrounded by four cells, which need to be marked, as this would make the central cell appear marked as well. The shaded variants do not exhibit this problem.

For as long as there is no need to differentiate one or a few of the cells in a group from the other cells in the same group, refer to the normal (that is, the non-"box"- or "var"-type) templates further above.

Character cell contents edit

Template:chset-cell — Character cell with character + Unicode value
Template:chset-cell3 — Character cell with character + Unicode value + decimal index
Template:chset-cell4 — Character cell with character + Unicode value + decimal + octal index
Template:chset-ctrl — Control character cell with name + Unicode value
Template:chset-ctrl3 — Control character cell with name + Unicode value + decimal index
Template:chset-ctrl4 — Control character cell with name + Unicode value + decimal + octal index
Template:chset-cell-unified — Any of the above, plus optional kuten