வார்ப்புரு:Key press/doc
{{Documentation subpage}}
 &lt;!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE END OF THIS PAGE. --&gt;
 {{Redirect|Template:Key|map key templates|Category:Legend templates}}
 {{Lua|Module:Key}}
 {{Uses TemplateStyles|Template:Key press/styles.css}}
 {{used in system|in [[MediaWiki:Clearyourcache]]}}
 __NOTOC__
 
 This is the {{tl|key press}} template primarily designed to illustrate keys and keystrokes on a [[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|A}} → {{key press|A}}
 As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.
 
 ===Keystroke combinations===
 To illustrate keystroke combinations, just use extra parameters:
 : {{tc|key press|Alt|P}} → {{key press|Alt|P}}
 : {{tc|key press|Ctrl|Alt|Del}} → {{key press|Ctrl|Alt|Del}}
 
 When you feed several key names to this template, it adds a &quot;+&quot; (or whatever the contents of the optional ''chain'' parameter) with no spaces around. This means it won't line wrap. But when you show key combinations for instance in a table that might cause items to be too wide. Instead manually build the key combination with spaces around the &quot;+&quot; so it can line wrap:
 : {{tc|key press|Ctrl}} + {{tlc|key press|Alt}} + {{tlc|key press|Del}} → {{key press|Ctrl}} + {{key press|Alt}} + {{key press|Del}}
 : {{tc|key press|Ctrl|Alt|Del|5=chain=&amp;amp;#32;+&amp;amp;#32;}} → {{key press|Ctrl|Alt|Del|chain=&amp;#32;+&amp;#32;}}
 
 To illustrate sequences where all keys do not need to be pressed simultaneously, the plus signs can be omitted by setting ''chain=''. For example, in most Windows systems in North America and Western Europe, [[Alt code]]s can be used to insert the [[plus-minus sign]] (±) by holding down the {{key press|Alt}} key while typing &lt;code&gt;0177&lt;/code&gt; with the [[numeric keypad]]:
 : {{tc|key press|Alt|0}}{{tlc|key press|1|7|7|chain{{=}}}} → {{key press|Alt|0}}{{key press|1|7|7|chain=}}
 
 An example of a use case where more than 5 might be used is explaining usage of a macro (keyboard shortcut) created by a [[Third-party software component|third-party application]]:
 : {{tc|Key press|Ctrl|Alt|Shift|Win|Menu|fn|L}} → {{Key press|Ctrl|Alt|Shift|Win|Menu|fn|L}}
 
 ===Wikilinks===
 If there is an article about the key you can [[WP:wikilink|wikilink]] the key's name like any other wiki text. Like this:
 * {{tc|key press|&amp;#91;&amp;#91;Alt key|Alt&amp;#93;&amp;#93;}} → {{key press|[[Alt key|Alt]]}}
 
 If you are wikilinking the keys, please ensure that you are piping to the correct page (e.g. &lt;code&gt;&lt;nowiki&gt;[[Alt key|Alt]]&lt;/nowiki&gt;&lt;/code&gt; instead of &lt;code&gt;&lt;nowiki&gt;[[Alt]]&lt;/nowiki&gt;&lt;/code&gt;, which leads to a [[WP:Disambiguation page|disambiguation page]]).
 
 ===Wiki markup characters===
 Some wiki markup characters, like the [[pipe symbol]] “{{Code|{{!}}|mediawiki}}”, the [[semicolon]] “{{Code|;|mediawiki}}” and the [[equals sign]] “{{Code|{{=}}|mediawiki}}”, need to be entered using the {{tlx|!}} ({{Tlx|Pipe}}), {{tlx|;}} and {{tlx|{{=}}}} templates or as an [[HTML entity]] {{Code|&amp;#124;|html}} ({{Code|&amp;#x7C;|html}}), {{Code|&amp;#59;|html}} ({{Code|&amp;#x3B;|html}}), {{Code|&amp;#61;|html}} ({{Code|&amp;#x3D;|html}}) respectively:
 * {{tc|key press|{{tc|!}}}} → {{key press|{{!}}}}
 * {{tc|key press|&amp;amp;#124;}} → {{key press|&amp;#124;}}
 * {{tc|key press|{{tc|&amp;#59;}}}} → {{key press|{{;}}}}
 * {{tc|key press|&amp;amp;#59;}} →  {{key press|&amp;#59;}}
 * {{tc|key press|{{tc|&amp;#61;}}}} → {{key press|{{=}}}}
 * {{tc|key press|&amp;amp;#61;}} →  {{key press|&amp;#61;}}
 
 However, if the characters are marked as wikilinks, they can be entered as such:
 * {{tc|key press|&lt;nowiki&gt;[[|]]&lt;/nowiki&gt;}} → {{key press|[[|]]}}
 * {{tc|key press|&lt;nowiki&gt;[[;]]&lt;/nowiki&gt;}} → {{key press|[[;]]}}
 * {{tc|key press|&lt;nowiki&gt;[[=]]&lt;/nowiki&gt;}} → {{key press|[[=]]}}
 
 Most markup characters also have alias templates:
 * {{tc|key press|pipe}} → {{key press|pipe}}
 * {{tc|key press|semicolon}} → {{key press|semicolon}}
 * {{tc|key press|equals}} → {{key press|equals}}
 * {{tc|key press|colon}} → {{key press|colon}}
 * {{tc|key press|asterisk}} → {{key press|asterisk}}
 * {{tc|key press|hash}} → {{key press|hash}}
 
 ===Key symbols===
 Some key names have a fitting [[Unicode]] character. This template automatically adds such &quot;icons&quot; to the following key names among others.
 * {{tc|key press|Shift}} → {{key press|Shift}}
 * {{tc|key press|Tab}} → {{key press|Tab}}
 * {{tc|key press|Enter}} → {{key press|Enter}}
 * {{tc|key press|Option}} → {{key press|Option}}
 * {{tc|key press|Opt}} → {{key press|Opt}}
 * {{tc|key press|Command}} → {{key press|Command}}
 * {{tc|key press|Cmd}} → {{key press|Cmd}}
 * {{tc|key press|Caps Lock}} → {{key press|Caps Lock}}
 * {{tc|key press|Up}} → {{key press|Up}}
 * {{tc|key press|Down}} → {{key press|Down}}
 * {{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 [[Windows key]] and [[Menu key]]. So this template shows approximate characters for them, namely the {{sc2|SQUARED PLUS}} and {{sc2|STRICTLY EQUIVALENT TO}} from the [[Mathematical Operators]] Unicode block:
 * {{tc|key press|Win}} → {{key press|Win}}
 * {{tc|key press|Menu}} → {{key press|Menu}}
 
 In some cases, the automatic recognition of tokens and consequently the addition of symbols may not be desired&lt;!-- for example in [[Reverse Polish notation]] which must distingish between plain normal Enter (without symbol) and Enter-with_automatic_duplication (with symbol) --&gt;; in these cases the token recognition can be suppressed by [[HTML encoding]] the text, e.g. &lt;code&gt;&lt;nowiki&gt;{{key press|&amp;amp;#x45;nter}}&lt;/nowiki&gt;&lt;/code&gt; will give {{key press|&amp;#x45;nter}} (plain text) instead of {{key press|Enter}} (token).
 
 ====Video games====
 Video game controllers often have specialized input labels that do not map easily. The following are mappings for various game consoles and input features.
 
 =====Directional input=====
 The following should only be used when the input sequence uses something other than the primary input or mixes input between directional devices.
 * {{tc|key press|l-down}} → {{key press|l-down}}
 * {{tc|key press|c-left}} → {{key press|c-left}}
 * {{tc|key press|r-up}} → {{key press|r-up}}
 
 Stick specific diagonals are also supported:
 * {{tc|key press|l-nw}} → {{key press|l-nw}}
 * {{tc|key press|c-se}} → {{key press|c-se}}
 * {{tc|key press|r-ne}} → {{key press|r-ne}}
 
 =====PlayStation=====
 * {{tc|key press|ex}} → {{key press|ex}}
 * {{tc|key press|circle}} → {{key press|circle}}
 * {{tc|key press|triangle}} → {{key press|triangle}}
 * {{tc|key press|square}} → {{key press|square}}
 {{clear}}
 
 ===TemplateData===
 {{TemplateDataHeader}}
 &lt;templatedata&gt;
 {
 &quot;description&quot;: &quot;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.&quot;,
 &quot;params&quot;: {
 &quot;1&quot;: {
 &quot;label&quot;: &quot;First key&quot;,
 &quot;description&quot;: &quot;First key&quot;,
 &quot;type&quot;: &quot;string/line&quot;,
 &quot;required&quot;: true
 },
 &quot;2&quot;: {
 &quot;label&quot;: &quot;Second key&quot;,
 &quot;description&quot;: &quot;Optional key press in combination as the first.&quot;,
 &quot;type&quot;: &quot;string/line&quot;,
 &quot;required&quot;: false
 },
 &quot;3&quot;: {
 &quot;label&quot;: &quot;Third key&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;4&quot;: {
 &quot;label&quot;: &quot;Fourth key&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;5&quot;: {
 &quot;label&quot;: &quot;Fifth key&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;6&quot;: {
 &quot;label&quot;: &quot;Sixth key&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;7&quot;: {
 &quot;label&quot;: &quot;Seventh key&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;8&quot;: {
 &quot;label&quot;: &quot;Eighth key&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;9&quot;: {
 &quot;label&quot;: &quot;Ninth key&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;10&quot;: {
 &quot;label&quot;: &quot;Tenth key&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;chain&quot;: {
 &quot;label&quot;: &quot;Chaining character&quot;,
 &quot;description&quot;: &quot;Character between chained key presses&quot;,
 &quot;default&quot;: &quot;+&quot;,
 &quot;inherits&quot;: &quot;2&quot;
 },
 &quot;chain first&quot;: {
 &quot;description&quot;: &quot;Character between first and second key to press&quot;,
 &quot;inherits&quot;: &quot;chain&quot;
 },
 &quot;chain second&quot;: {
 &quot;description&quot;: &quot;Character between second and third key to press&quot;,
 &quot;inherits&quot;: &quot;chain&quot;
 },
 &quot;chain third&quot;: {
 &quot;description&quot;: &quot;Character between third and fourth key to press&quot;,
 &quot;inherits&quot;: &quot;chain&quot;
 },
 &quot;chain fourth&quot;: {
 &quot;description&quot;: &quot;Character between fourth and fifth key to press&quot;,
 &quot;inherits&quot;: &quot;chain&quot;
 }
 }
 }
 &lt;/templatedata&gt;
 
 ===See also===
 * {{tlx|Key top}} – produces a similar visual effect, but includes more symbols and does not directly support key combinations (e.g. {{key top|Caps Lock}})
 * {{tlx|Button}} – produces a similar visual effect but without the semantic markup (e.g. {{Button|sample text}}); more for representing interface elements.
 * {{tlx|Kbd}} – to indicate user input (of any kind) without making it look like keys or buttons
 
 {{Semantic markup templates}}
 
 &lt;includeonly&gt;{{Sandbox other||
 &lt;!-- CATEGORY LINKS BELOW THIS LINE, PLEASE: --&gt;
 [[Category:Programming typing-aid templates]]
 &lt;!-- [[Category:Graphic templates]] - Don't add this one; this isn't a graphic template, as it's all done in CSS. --&gt;
 [[Category:Semantic markup templates]]
 [[Category:Software templates]]
 [[Category:Computer keys|τ]]
 
 [[nl:Sjabloon:Toets]]
 [[sl:Predloga:Keypress]]