Template:Control code link/doc

From HandWiki

Used for linking mnemonic codes for control codes, whitespace characters and format effectors, as well as any other characters requiring reference by mnemonics in the manner of control codes (such as the Wansung and N-byte Hangul fillers). The intent is to allow code charts (including Unicode block charts and more especially Unicode mapping charts) and other references to control code mnemonics to link to the destination which best explains that character, and to allow these links to be changed across the board if more detailed information is added elsewhere or if information is moved.

An optional internal=1 parameter may be provided, which will force the link to point to an anchor within the same article, and format the link in the style of {{Glossary link internal}}. This is appropriate if (a) the link is expected to necessarily go to an anchor in the same article (say, within C0 and C1 control codes), and (b) it isn't somewhere (such as a code chart) where a blue link would be expected in all cases. This can help avoid a "sea of blue" effect in a page documenting a large number of such characters. {{Glossary link internal}} itself cannot be used since it is constructed for a different system of anchors which uses lowercase initial letters, and the anchors used by this template (both in internal and normal mode) are block capital.

There is one mandatory positional parameter, which is the mnemonic, in block capitals. When internal=1 is used, this is merely an anchor name within the article. When internal=1 is not used, it will recognise most common mnemonics for control and format characters and direct the link to a relevant article, or to a relevant anchor within an article. A few exceptions to note:

  • The mnemonic FS is used for two different controls in different sets: use ASCII:FS for File Separator and EBCDIC:FS for the S/360 CPU control Field Separator.
  • The mnemonic OSC is used for two different controls in different sets: use ANSI:OSC or ECMA:OSC for Operating System Command and DIN:OSC for Optional Syllabification Control.
  • The mnemonic SOS is used for two different controls in different sets: use ANSI:SOS or ECMA:SOS for Start of String and EBCDIC:SOS for the S/360 CPU control Start of Significance.

The default link label is the mnemonic, with anything before the last colon removed (so, without any ASCII/ANSI/ECMA/ISO/EBCDIC prefix). This can be overridden by the optional second positional parameter, which should contain the desired link label wikitext.