Template:Key press: Difference between revisions

From Vintage Story Wiki
(creating a template for Key_press)
 
No edit summary
Line 1: Line 1:
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.
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.
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 "+" (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 "+" 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= + }} → {{key press|Ctrl|Alt|Del|chain= + }}
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 <code>0177</code> 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 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|&#91;&#91;Alt key|Alt&#93;&#93;}} → {{key press|[[Alt key|Alt]]}}
If you are wikilinking the keys, please ensure that you are piping to the correct page (e.g. <code><nowiki>[[Alt key|Alt]]</nowiki></code> instead of <code><nowiki>[[Alt]]</nowiki></code>, which leads to a [[WP:Disambiguation page|disambiguation page]]).
===Wiki markup characters===
Some wiki markup characters, like the [[pipe symbol]], the [[semicolon]] and the [[equals sign]], need to be entered using the {{tlx|!}}, {{tlx|;}} and {{tlx|{{=}}}} templates or as an [[HTML entity]] &amp;#124;, &amp;#59;, &amp;#61; respectively:
* {{tc|key press|{{tc|pipe}}}} → {{key press|{{pipe}}}}
* {{tc|key press|&amp;#124;}} → {{key press|&#124;}}
* {{tc|key press|{{tc|&#59;}}}} → {{key press|{{;}}}}
* {{tc|key press|&amp;#59;}} →  {{key press|&#59;}}
* {{tc|key press|{{tc|&#61;}}}} → {{key press|{{=}}}}
* {{tc|key press|&amp;#61;}} →  {{key press|&#61;}}
However, if the characters are marked as wikilinks, they can be entered as such:
* {{tc|key press|<nowiki>[[|]]</nowiki>}} → {{key press|[[|]]}}
* {{tc|key press|<nowiki>[[;]]</nowiki>}} → {{key press|[[;]]}}
* {{tc|key press|<nowiki>[[=]]</nowiki>}} → {{key press|[[=]]}}
Most markup characters also have aliases:
* {{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===
===Key symbols===
Line 68: Line 23:
* {{tc|key press|Win}} → {{key press|Win}}
* {{tc|key press|Win}} → {{key press|Win}}
* {{tc|key press|Menu}} → {{key press|Menu}}
* {{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<!-- for example in [[Reverse Polish notation]] which must distingish between plain normal Enter (without symbol) and Enter-with_automatic_duplication (with symbol) -->; in these cases the token recognition can be suppressed by [[HTML encoding]] the text, e.g. <code><nowiki>{{key press|&amp;#x45;nter}}</nowiki></code> will give {{key press|&#x45;nter}} (plain text) instead of {{key press|Enter}} (token).
===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": "Fourth 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===
* {{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}}
}}

Revision as of 00:35, 31 July 2023

This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block:

  • Template:TcTemplate loop detected: Template:Key press
  • Template:TcTemplate loop detected: Template:Key press
  • Template:Tc → This is the {{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.

As lower-case alphabetic characters a–z do not appear on most keyboards, they should not be used as parameters.

Key symbols

Some key names have a fitting Unicode character. This template automatically adds such "icons" to the following key names among others.

File:AltGr Win Menu Ctrl key.jpg
Windows key and Menu key
File:Ctl wndws alt.jpg
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 Template:Sc2 and Template:Sc2 from the Mathematical Operators Unicode block: