Шаблон:Клавиша/Документация

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

Примеры:

{{клавиша|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

Для графического оформления w: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

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

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

{{клавиша||}} → |

{{клавиша||}} → |

{{клавиша|[[:Шаблон:;]]}} → Шаблон:;

{{клавиша|;}} → ;

{{клавиша|{{=}}}} → =

{{клавиша|=}} → =

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

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

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

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

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

{{клавиша|вертикальная черта}} → |

{{клавиша|точка с запятой}} → ;

{{клавиша|равенство}} → =

{{клавиша|двоеточие}} → :

{{клавиша|астериск}} → *

{{клавиша|решётка}} → #

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

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

Клавиша Windows (старая версия)

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

{{клавиша|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 и («Меню», «Контекстное меню») не существует, шаблон заменяет их символами Squared Plus («плюс в квадрате») и Strictly Equivalent To («строго эквивалентно») из блока математических операторов Юникода:

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