Template:Chset-color-ctrl-box/doc
 | This is a documentation subpage for Template:Chset-color-ctrl-box It may contain usage information, categories and other content that is not part of the original template page. |
Usage
[edit source]Used with Template:chset-tableformat data rows to indicate a color for control character code cells, this alternative is a boxed variant of Template:chset-color-ctrl in order to indicate some other information in addition to the type, for example, a derivation from a base codepage or a codepoint, for which multiple definitions exist in some sources.
The default color of the box is gray, but can be changed by providing an optional parameter specifying the color.
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, use Template:chset-color-ctrl instead.
For example:
{{chset-color-ctrl-box}}|{{chset-ctrl3|0000|[[Null character|NUL]]|0}}
{{chset-color-ctrl-box}}|{{chset-ctrl3|0001|[[Start of heading|SOH]]|1}}
{{chset-color-ctrl-box}}|{{chset-ctrl3|0002|[[Start of text|STX]]|2}}
{{chset-color-ctrl-box}}|{{chset-ctrl3|0003|[[End of text|ETX]]|3}}
{{chset-color-ctrl-box|red}}|{{chset-ctrl3|0000|[[Null character|NUL]]|0}}
Chset family of templates
[edit source]See ISO 8859-1, Windows-1252, and EBCDIC for examples of usage.
Header and footer rows
[edit source]- 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 source]- Template:chset-left — Left row code header
Character cell colors
[edit source]- 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 source]- 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