Template:Chset-ctrl3/doc


Note

edit

This template replaces Template:chset-ctrl. Template:chset-ctrl4 is available to additionally display the code point in octal.

Usage

edit

Used with Template:chset-tableformat to indicate a table cell for a control character or non-printing punctuation character.

  • Parameter 1: hhhh, Hexadecimal Unicode value, 4 digits (e.g., 0020)
  • Parameter 2: XX, Character name (e.g., SP), with link to appropriate article
  • Parameter 3: dd, Decimal character code, 1–3 digits (e.g., 32)

For example, the first four ASCII control characters (Unicode U+0000 thru U+0003, decimal 0 thru 3) are coded as rows in a character set table like this:

{|
|{{chset-color-ctrl}}|{{chset-ctrl3|0000|[[Null character|NUL]]|0}}
|{{chset-color-ctrl}}|{{chset-ctrl3|0001|[[Start of heading|SOH]]|1}}
|{{chset-color-ctrl}}|{{chset-ctrl3|0002|[[Start of text|STX]]|2}}
|{{chset-color-ctrl}}|{{chset-ctrl3|0003|[[End of text|ETX]]|3}}
|}

Which yields:

NUL
0000
0
SOH
0001
1
STX
0002
2
ETX
0003
3

Another example illustrates the coding for a few of the ISO/IEC non-printing punctuation characters:

{|
|{{chset-color-misc}}|{{chset-ctrl3|0020|[[Space (character)|SP]]|32}}
|{{chset-color-misc}}|{{chset-ctrl3|00A0|[[Non-breaking space|NBSP]]|160}}
|{{chset-color-ctrl}}|{{chset-ctrl3|00AD|[[Soft hyphen|SHY]]|173}}
|}

Which yields:

SP
0020
32
NBSP
00A0
160
SHY
00AD
173

Chset family of templates

edit

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

edit

Character row header

edit

Character cell colors

edit

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:

and

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