Template:Control code link/doc: Difference between revisions

Content deleted Content added
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 1:
{{Documentation subpage|[[Template:Control code link]]}}
<!----Please place categories where indicated at the bottom of this page---->
{{Uses TemplateStyles |Template:Control code link/styles.css}}
Used for linking mnemonic codes for [[C0 and C1 control codes|control codes]], [[whitespace character]]s and [[Unicode control characters|format effectors]].
Used for linking mnemonic codes for [[C0 and C1 control codes|control codes]], [[whitespace character]]s and [[Unicode control characters|format effectors]], as well as any other characters requiring reference by mnemonics in the manner of control codes (such as the [[KS X 1001#Hangul Filler|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 {{code|1=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 {{tlx|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. {{tlx|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 {{code|1=internal=1}} is used, this is merely an anchor name within the article. When {{code|1=internal=1}} is {{em|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 {{code|FS}} is used for two different controls in different sets: use {{code|ASCII:FS}} for {{Control code link|ASCII:FS|File Separator}} and {{code|EBCDIC:FS}} for the S/360 CPU control {{Control code link|EBCDIC:FS|Field Separator}}.
* The mnemonic {{code|OSC}} is used for two different controls in different sets: use {{code|ANSI:OSC}} or {{code|ECMA:OSC}} for {{Control code link|ANSI:OSC|Operating System Command}} and {{code|DIN:OSC}} for {{Control code link|DIN:OSC|Optional Syllabification Control}}.
* The mnemonic {{code|SOS}} is used for two different controls in different sets: use {{code|ANSI:SOS}} or {{code|ECMA:SOS}} for {{Control code link|ANSI:SOS|Start of String}} and {{code|EBCDIC:SOS}} for the S/360 CPU control {{Control code link|EBCDIC:SOS|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.
 
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!----Categories below this line, please:---->
[[Category:Internal article-link templates]]
[[Category:Unicode templates]]
}}</includeonly>