Mapeamento de atalhos

Todos os comandos do OctoEdit — edição integrada, alternâncias de exibição e comandos fornecidos por plugins — podem ser remapeados, desvinculados ou redefinidos a partir de um único lugar: Preferências ▸ Atalhos.

A tabela

A página lista todos os comandos com sua Categoria, o Atalho atual e o Padrão. As linhas personalizadas aparecem em negrito; a caixa de filtro reduz a lista enquanto você digita (ela procura no nome do comando, na categoria, na combinação de teclas e no identificador interno do comando).

As alterações são acumuladas enquanto você edita e aplicadas quando você pressiona OK ou Aplicar — menus, paleta de comandos e janelas de plugins adotam as novas combinações imediatamente, sem reiniciar. Cancelar descarta tudo o que você tinha preparado.

Remapeando um comando

1. Selecione uma linha.
2. Clique no campo Novo atalho e pressione a combinação que você quer.
3. Clique em Atribuir (ou em Remover a atribuição para remover a associação, ou em Redefinir para o padrão).

Uma combinação precisa incluir Ctrl, Alt ou Meta, ou então ser uma tecla de função (F1–F12, com quaisquer modificadores). Teclas de digitação e navegação sozinhas ou apenas com Shift — letras, Enter, Backspace, Delete, setas, Home/End, PageUp/PageDown e Tab/Esc — são reservadas: elas digitam ou movem o cursor, então o mapeador as recusa.

Teclas fixas

Tab e Esc dentro do editor (expansão de snippets e campos, recuo, recolher vários cursores, fechar popups) são comportamentos fixos, não comandos remapeáveis, e nunca aparecem na tabela.

Conflitos

Dois comandos nunca podem ter a mesma combinação no mesmo contexto — isso deixaria ambos mortos —, então o mapeador impede isso de antemão:

• Atribuir uma combinação já ocupada mostra uma mensagem em linha nomeando quem a detém. Escolha outra combinação, ou clique em Reatribuir para trazê-la para cá — o detentor anterior fica desvinculado (uma alteração que você vê e pode desfazer na linha dele).
• Quando um plugin recém-instalado traz um padrão que colide com a sua configuração existente, quem já estava lá fica com a tecla: o recém-chegado é suspenso durante a sessão, um aviso aparece e a linha mostra (suspenso: conflita com …). A suspensão nunca é salva — no momento em que a combinação vencedora sai de cena, o padrão suspenso volta à vida.
• A mesma combinação pode aparecer legitimamente em contextos diferentes — por exemplo, Ctrl+Z é Editar ▸ Desfazer globalmente e "desfazer alteração copiada" dentro de uma aba de comparação; enquanto a visualização dela tem o foco, vence a associação mais específica.

Mapas de teclado: exportar, importar, predefinições

• Exportar… salva suas personalizações em um arquivo JSON ({"version": 1, "overrides": { "<command id>": "<chord>" }}).
• Importar… substitui toda a sua configuração pela do arquivo (após uma confirmação). Entradas de comandos que não existem na sua instalação são ignoradas e contabilizadas, de modo que os mapas de teclado sobrevivem a mudanças de versão e de plugins.
• Carregar uma predefinição aplica um mapa de teclado incluído — VS Code e Notepad++ vêm de fábrica (a maioria dos padrões já coincide com esses editores; as predefinições cobrem as combinações que diferem, como os comandos de dobra).

Manutenção

• Redefinir tudo… devolve todos os comandos ao seu padrão.
• Remover as entradas obsoletas… apaga as personalizações salvas que pertencem a comandos que não estão mais instalados (por exemplo, um plugin desinstalado). Do contrário elas são preservadas, então reinstalar um plugin restaura suas associações.

Tip

A paleta de comandos sempre exibe a combinação atual ao lado de cada comando, então ela também serve de referência rápida depois de uma sessão de remapeamento.