Template:Key/doc: Difference between revisions

Content added Content deleted

Inline

Latest revision as of 03:44, 30 March 2022

This is the documentation page, it should be transcluded into the main template page. See Template:Documentation for more information

When used, this template displays game controls, supporting both keyboard keys and controller buttons.

Images used by this template are hosted at Fandom Commons.
This template's display is styled using the .keysDark and .keysLight classes located in MediaWiki:Common.css.

Usage

Note: For a summary of possible console, key, and button values, see key library.

Keyboard

If using the template for keyboard keys, there is only one required input. For mouse usage, see the #Consoles and controllers, using "mouse" as the console.

{{key|button}}

button is the keyboard key to be pressed. Some key inputs, such as Shift or Tab will automatically add symbols or other formatting. Any other inputs will be output as they are with the first letter capitalized.
Optional: there is an additional parameter, keyboardvariant which determines whether the key is dark text on a light key (default) or the inverse. This will likely never be used, and if a wiki would prefer light on dark, it should be changed as the default.

Example

Press {{Key|Shift}} and {{Key|F}} at the same time.

produces: Press {{#vardefine:console|}}{{#vardefine:key|{{{2}}}}}{{#vardefine:keyboard|shift}}Template:!((File:undefined {{#var:key}}.png|alt={{#var:key}}|20px|link=|{{#var:key}}Template:))!{{#var:keyboard}} and {{#vardefine:console|}}{{#vardefine:key|{{{2}}}}}{{#vardefine:keyboard|f}}Template:!((File:undefined {{#var:key}}.png|alt={{#var:key}}|20px|link=|{{#var:key}}Template:))!{{#var:keyboard}} at the same time.

Consoles and controllers

{{key|console|button|size=optional size}}

console is the console the key belongs to. The parameter is not case-sensitive and supports many possible consoles. See key library. for possible values.
button is the button to be pressed, such as "A" or "Right Trigger". While the template tries to be intuitive such that the correct input for a button is whatever you think it is, if your attempt at a button isn't working, see key library. for possible values.
The size parameter is optional, and sizes the button image. If this parameter is not entered, the default image size is 20px.

Example

Press {{Key|Xbox|RT}} to open your inventory wheel and select the item with {{Key|Xbox|A}}

Changing the default color

The default color for the keyboard and mouse is suitable for dark-skinned wikis. To change the default settings so it fits for a light-skinned wiki, without having to use keyboardvariant = light each time, you can search for and change these sections in the template:

Search for: |#default = _White_Mouse_
...and change it to: |#default = _Black_Mouse_

Search for: <kbd class="{{#switch: {{lc:{{{keyboardvariant}}}}} |dark=keysDark|light=keysLight|

keysDark

}}">

...and change keysDark at the end of the line to keysLight.

@@ Line 1: / Line 1: @@
+{{Documentation subpage}}
-{{doc/start}}
+<!-- Documentation here -->
 When used, this template displays game controls, supporting both keyboard keys and controller buttons.
-* Images used by this template are hosted at http://commons.gamepedia.com.
+* Images used by this template are hosted at Fandom Commons.
 * This template's display is styled using the <code>.keysDark</code> and <code>.keysLight</code> classes located in [[MediaWiki:Common.css]].
 == Usage ==
-* '''Note:''' For a summary of possible console, key, and button values, see [[Template:Key/library]].
+* '''Note:''' For a summary of possible console, key, and button values, see [[wikia:Template:Key/library|key library]].
 === Keyboard ===
 If using the template for keyboard keys, there is only one required input. For mouse usage, see the [[#Consoles and controllers]], using "mouse" as the console.
-'''<code><nowiki>{{</nowiki>key | ''button'' <nowiki>}}</nowiki></code>'''
+<code><nowiki>{{key|button}}</nowiki></code>
 * <code>button</code> is the keyboard key to be pressed. Some key inputs, such as Shift or Tab will automatically add symbols or other formatting. Any other inputs will be output as they are with the first letter capitalized.
 * ''Optional'': there is an additional parameter, <code>keyboardvariant</code> which determines whether the key is dark text on a light key (default) or the inverse. This will likely never be used, and if a wiki would prefer light on dark, it should be changed as the default.
-====Example====
+==== Example ====
+<pre>
-<pre>Press {{Key|Shift}} and {{Key|F}} at the same time.</pre>
+Press {{Key|Shift}} and {{Key|F}} at the same time.
-produces:<br/>
+</pre>
+produces:
 Press {{Key|Shift}} and {{Key|F}} at the same time.
 === Consoles and controllers ===
-'''<code><nowiki>{{</nowiki>key | ''console'' | ''button'' | size = ''optional size'' <nowiki>}}</nowiki></code>'''
+<code><nowiki>{{key|console|button|size=optional size}}</nowiki></code>
-* <code>console</code> is the console the key belongs to. The parameter is '''not''' case-sensitive and supports many possible consoles. See [[Template:Key/library]] for possible values.
+* <code>console</code> is the console the key belongs to. The parameter is '''not''' case-sensitive and supports many possible consoles. See [[wikia:Template:Key/library|key library]]. for possible values.
-* <code>button</code> is the button to be pressed, such as "A" or "Right Trigger". While the template tries to be intuitive such that the correct input for a button is whatever you think it is, if your attempt at a button isn't working, see [[Template:Key/library]] for possible values.
+* <code>button</code> is the button to be pressed, such as "A" or "Right Trigger". While the template tries to be intuitive such that the correct input for a button is whatever you think it is, if your attempt at a button isn't working, see [[wikia:Template:Key/library|key library]]. for possible values.
 * The <code>size</code> parameter is optional, and sizes the button image. If this parameter is not entered, the default image size is 20px.
-====Example====
+==== Example ====
+<pre>
-<pre>Press {{Key|Xbox|RT}} to open your inventory wheel and select the item with {{Key|Xbox|A}}</pre>
-produces:<br/>
 Press {{Key|Xbox|RT}} to open your inventory wheel and select the item with {{Key|Xbox|A}}
+</pre>
 == Changing the default color ==
 The default color for the keyboard and mouse is suitable for dark-skinned wikis. To change the default settings so it fits for a light-skinned wiki, without having to use <code>keyboardvariant = light</code> each time, you can search for and change these sections in the template:
 Search for: <code>|#default = _White_Mouse_</code><br/>
@@ Line 42: / Line 44: @@
 ...and change ''keysDark'' at the end of the line to <code>''keysLight''</code>.
+<includeonly>
-{{doc/end}}
+<!-- Template categories/interwikis here -->
+[[Category:Templates]]
+[[Category:Formatting templates]]
+[[Category:Templates to simplify or eliminate]]
+[[Category:Uses Variables extension]]
+</includeonly>