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

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

Примеры:

  • {{клавиша|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}}. Это исключает многократное дублирование кода в основном шаблоне.