(i) Документация

Шаблон {{клавиша}} позволяет графически оформлять названия клавиш клавиатуры компьютера и их сочетания. Один шаблон, используемый с дополнительными параметрами, может служить для изображения нескольких одновременно нажимаемых клавиш. Последовательность нажатий клавиш можно проиллюстрировать с помощью нескольких шаблонов.

Примеры:

{{клавиша|A}}A
{{клавиша|A|B|C}}A+B+C
{{клавиша|A}}{{клавиша|B}}{{клавиша|C}}ABC

Был ҡалыптың башҡа исеме  — {{key}}.

Комбинации клавиш

Для графического оформления клавиатурных комбинаций используйте дополнительные параметры:

{{клавиша|Alt|P}}Alt+P
{{клавиша|Ctrl|Alt|Del}}Ctrl+Alt+Del

В настоящее время шаблон обрабатывает до 10 параметров с названиями клавиш, что позволяет изобразить практически любую необходимую клавиатурную комбинацию. При указании 11-го параметра шаблон добавляет страницу в категорию Страницы с некорректным использованием шаблона «Клавиша». Категория позволяет легко найти страницы с ошибками в шаблоне и исправить их или убедиться в том, что шаблон действительно нуждается в большем количестве параметров.

Названия клавиш, выводимые шаблоном, автоматически разделяются знаком + (а также любым другим символом или набором символов, указанным в поле |разделитель1…9=) без пробелов с обеих сторон, в результате чего изображаемая клавиатурная комбинация не переносится на следующую строку. Но такой текст может оказаться слишком широким, например, для показа в узкой таблице. В этом случае сочетание клавиш можно построить вручную из нескольких обращений к шаблону {{клавиша}}, разделённых знаком + и обычным пробелом, или дополнив разделитель HTML-кодом пробела  :

{{клавиша|Ctrl}} + {{клавиша|Alt}} + {{клавиша|Del}}Ctrl + Alt + Del
{{клавиша|Ctrl|Alt|Del|разделитель= + }}Ctrl + Alt + Del

Для графического оформления Alt-кодов Windows можно использовать несколько шаблонов {{клавиша}} без разделяющих символов или пробелов. Так, в большинстве североамериканских и западноевропейских версий операционной системы Windows символ ± можно ввести, удерживая клавишу Alt и набрав на цифровой клавиатуре 0177:

{{клавиша|Alt|0}}{{клавиша|1}}{{клавиша|7}}{{клавиша|7}}Alt+0177

Пример макроса (клавиатурного сокращения) из 7 клавиш, созданного сторонним приложением:

{{клавиша|Ctrl|Alt|Shift|Win|Menu|fn|L}}Ctrl+Alt+ Shift+ Win+ Menu+fn+L

Внутренние ссылки

Если в Википедии есть статья, посвящённая отдельной клавише, на неё можно дать обычную внутреннюю ссылку:

{{клавиша|[[Ctrl]]}}Ctrl

При добавлении ссылки убедитесь, что название статьи содержит необходимое уточнение — например, [[Alt (клавиша)|Alt]] вместо прямой ссылки [[Alt]], ведущей на страницу разрешения неоднозначности Alt:

{{клавиша|[[Alt (клавиша)|Alt]]}}Alt

Символы вики-разметки

Символы вики-разметки — например, вертикальная черта, точка с запятой и знак равенства — обрабатываются только в виде шаблонов-заменителей {{!}}, {{;}}, {{=}} или HTML-кодов |, &#59;, = соответственно:

{{клавиша|{{!}}}}|
{{клавиша||}}|
{{клавиша|{{;}}}};
{{клавиша|&#59;}};
{{клавиша|{{=}}}}=
{{клавиша|=}}=

Однако те же символы, оформленные как внутренние ссылки, можно указывать напрямую:

{{клавиша|[[|]]}}|
{{клавиша|[[;]]}};
{{клавиша|[[=]]}}=

Кроме того, допускается указание большинства символов вики-разметки с помощью их словесных эквивалентов («псевдонимов»):

{{клавиша|вертикальная черта}}|
{{клавиша|точка с запятой}};
{{клавиша|равенство}}=
{{клавиша|двоеточие}}:
{{клавиша|астериск}}*
{{клавиша|решётка}}#

Клавиши со специальными символами

Клавиши Windows и Menu («Меню», «Контекстное меню»)
Клавиша Windows (старая версия)

Названия некоторых клавиш содержат специальные символы (пиктограммы) Юникода. Шаблон автоматически добавляет эти символы к следующим названиям:

{{клавиша|Shift}} Shift
{{клавиша|Tab}}Tab
{{клавиша|Enter}} Enter
{{клавиша|Backspace}}← Backspace
{{клавиша|Caps Lock}} Caps Lock
{{клавиша|Option}} Option
{{клавиша|Opt}} Opt
{{клавиша|Command}} Command
{{клавиша|Cmd}} Cmd
{{клавиша|Up}}
{{клавиша|Down}}
{{клавиша|Left}}
{{клавиша|Right}}

Поскольку специальных символов для клавиш Windows и Menu[en] («Меню», «Контекстное меню») не существует, шаблон заменяет их символами Squared Plus («плюс в квадрате») и Strictly Equivalent To («строго эквивалентно») из блока математических операторов[en] Юникода:

{{клавиша|Win}} Win
{{клавиша|Menu}} Menu

Видеоигры

Контроллеры видеоигр часто используют специализированные метки ввода, не всегда легко поддающиеся схематическому описанию. Ниже приведены условные обозначения последовательностей ввода для игровых консолей и других аналогичных устройств.

Направленный ввод

Следующие условные обозначения (l — левый, c — центр, r — правый, up — вверх, down — вниз, left — влево, right — вправо) предназначены для случаев, когда последовательность ввода содержит действия помимо первичного ввода или смешанный ввод с нескольких направленных устройств:

{{клавиша|l-down}}L↓
{{клавиша|c-left}}C←
{{клавиша|r-up}}R↑

Диагональные движения джойстика обозначаются комбинациями первых букв английских названий сторон света (n — north, север; s — south, юг; w — west, запад; e — east, восток):

{{клавиша|l-nw}}L↖
{{клавиша|c-se}}C↘
{{клавиша|r-ne}}R↗

PlayStation

{{клавиша|ex}}×
{{клавиша|circle}}
{{клавиша|triangle}}
{{клавиша|square}}

Технические подробности

Шаблон {{клавиша}} вызывает подшаблон с базовым кодом {{клавиша/button}}. Это исключает многократное дублирование кода в основном шаблоне.

Во избежание поломок страниц, использующих данный шаблон, желательно экспериментировать в своём личном пространстве.