Changes

Jump to navigation Jump to search

Template:Key press/doc

1,741 bytes removed, 09:37, 23 October 2020
Clean up of the template for the relax wiki.
__NOTOC__
This is the {{tl|key press}} template primarily designed to illustrate keys and keystrokes on a [[wikipedia:computer keyboard]]. With additional parameters, a single template can even illustrate a combination of multiple ''simultaneous'' keystrokes. A sequence of keystrokes, on the other hand, need to be demonstrated with separate templates.
Example
: {{tc|key press|Ctrl|Alt|Del|5=chain= + }} → {{key press|Ctrl|Alt|Del|chain= + }}
On the other hand, to illustrate Windows [[wikipedia:Alt code]]s you might want to use separate templates with no intervening punctuation or space. In most Windows systems in North America and Western Europe, for example, the [[wikipedia:plus-minus sign]] (±) can be entered by holding down the Alt key while typing <code>0177</code> (with the [[wikipedia:numeric keypad]]):
: {{tc|key press|Alt|0}}{{tlc|key press|1}}{{tlc|key press|7}}{{tlc|key press|7}} → {{key press|Alt|0}}{{key press|1}}{{key press|7}}{{key press|7}}
===Wikilinks===
If there is an article about the key you can [[wikipedia:WP:wikilink|wikilink]] the key's name like any other wiki text. Like this:* {{tc|key press|<nowiki>[[wikipedia:Alt key|Alt]]</nowiki>}} → {{key press|[[wikipedia:Alt key|Alt]]}}
If you are wikilinking the keys, please ensure that you are piping to the correct page (e.g. <code><nowiki>[[Control key|Ctrl]]</nowiki></code> instead of <code><nowiki>[[Ctrl]]</nowiki></code>, which leads to a [[wikipedia:WP:Disambiguation page|disambiguation page]]).
===Wiki markup characters===
Some wiki markup character, like the [[wikipedia:pipe symbol]], the [[wikipedia:semicolon]] and the [[wikipedia:equals sign]], need to be entered using the {{tl|!}}, {{tl|;}} and {{tl|{{=}}}} templates or as an [[wikipedia:HTML entity]] &amp;#124;, &amp;#59;, &amp;#61; respectively:
* {{tc|key press|{{tc|!}}}} → {{key press|{{!}}}}
* {{tc|key press|&amp;#124;}} → {{key press|&#124;}}
However, if the characters are marked as wikilinks, they can be entered as such:
* {{tc|key press|<nowiki>[[wikipedia:&#124;]]</nowiki>}} → {{key press|[[wikipedia:|wikipedia:]]}}* {{tc|key press|<nowiki>[[wikipedia:;]]</nowiki>}} → {{key press|[[wikipedia:;]]}}* {{tc|key press|<nowiki>[[wikipedia:=]]</nowiki>}} → {{key press|[[wikipedia:=]]}}
Most markup characters also have aliases:
===Key symbols===
Some key names have a fitting [[wikipedia:Unicode]] character. This template automatically adds such "icons" to the following key names among others.
* {{tc|key press|Shift}} → {{key press|Shift}}
* {{tc|key press|Tab}} → {{key press|Tab}}
* {{tc|key press|Left}} → {{key press|Left}}
* {{tc|key press|Right}} → {{key press|Right}}
[[File:AltGr Win Menu Ctrl key.jpg|thumb|200px|Windows key and Menu key]][[File:Ctl wndws alt.jpg|thumb|200px|Old-style Windows key]]There are no characters for the [[wikipedia:Windows key]] and [[wikipedia:Menu key]]. So this template shows approximate characters for them, namely the 'SQUARED PLUS' and 'STRICTLY EQUIVALENT TO' from the [[wikipedia:Mathematical Operators]] block:
* {{tc|key press|Win}} → {{key press|Win}}
* {{tc|key press|Menu}} → {{key press|Menu}}
This template calls {{tl|key press/core}}, which holds the code that otherwise would be repeated several times in {{tl|key press}}, thus simplifying the code.
===TemplateData===
{{TemplateDataHeader}}
<templatedata>
{
"description": "Illustrates keys and keystrokes on a computer keyboard. Keys can include: Ctrl, Alt, Del, Opt, Menu, Left etc. console keys: ex, circle, triangle, square, and left right and center analog sticks: l-down, c-left, r-ne. The names are case insensitive.",
"params": {
"1": {
"label": "First key",
"description": "First key",
"type": "string/line",
"required": true
},
"2": {
"label": "Second key",
"description": "Optional key press in combination as the first.",
"type": "string/line",
"required": false
},
"3": {
"label": "Third key",
"inherits": "2"
},
"4": {
"label": "Forth key",
"inherits": "2"
},
"5": {
"label": "Fifth key",
"inherits": "2"
},
"6": {
"label": "Sixth key",
"inherits": "2"
},
"7": {
"label": "Seventh key",
"inherits": "2"
},
"8": {
"label": "Eighth key",
"inherits": "2"
},
"9": {
"label": "Ninth key",
"inherits": "2"
},
"10": {
"label": "Tenth key",
"inherits": "2"
},
"chain": {
"label": "Chaining character",
"description": "Character between chained key presses",
"default": "+",
"inherits": "2"
},
"chain first": {
"description": "Character between first and second key to press",
"inherits": "chain"
},
"chain second": {
"description": "Character between second and third key to press",
"inherits": "chain"
},
"chain third": {
"description": "Character between third and fourth key to press",
"inherits": "chain"
},
"chain fourth": {
"description": "Character between fourth and fifth key to press",
"inherits": "chain"
}
}
}
</templatedata>
===See also===
<includeonly>
<!-- CATEGORY LINKS BELOW THIS LINE, PLEASE: -->
[[Category:Programming typing-aid templates]]
<!-- [[Category:Graphic templates]] - Don't add this one; this isn't a graphic template, as it's all done in CSS. -->
[[Category:Semantic markup templates]]
[[Category:Software templates]]
[[Category:Computer keys|τ]]
 
[[nl:Sjabloon:Toets]]
[[sl:Predloga:Keypress]]
</includeonly>
Trusted, Bureaucrats
4,228

edits

Navigation menu