// Documentação do Singularity
Aperture, a paleta de comandos
O Aperture é o ponto de entrada único para te deslocares no Singularity. Abre a paleta, escreve alguns caracteres e salta para uma vista, um ficheiro, um ticket, um projeto ou o respetivo cockpit Git sem percorrer a interface.
Abrir o Aperture
Prime ⌘K no macOS ou Ctrl K no Windows e no Linux. Também podes clicar no logótipo animado ao centro da barra de título. O campo recebe imediatamente o foco: basta começares a escrever.
O Aperture reúne a navegação e a pesquisa numa única janela. Um âmbito apresentado por cima dos resultados permite ficar no espaço de trabalho ativo ou alargar a pesquisa ao namespace atual, quando existe.

O que lá encontras
Os comandos nativos estão agrupados por utilização:
- Vistas: Mission Control, Terminal, Editor, Git, Marketplace e Settings. Experimenta
terminal,editorousettings: os aliases em inglês funcionam mesmo que a interface esteja em francês. - Ficheiros: o caminho relativo, a primeira linha correspondente e o projeto. Escreve, por exemplo,
workbench-commandsou um fragmento de código comoopenProjectGit. - Tickets: o título, a referência e o projeto. Uma pesquisa como
documentationencontra os tickets cujo título contém esse texto. - Projetos e Git: o nome ou o caminho do projeto;
git Singularityabre diretamente o cockpit Git desse projeto. - Organização: mudar para um espaço de trabalho ou um namespace, criar um New workspace (novo espaço de trabalho) ou um New namespace (novo namespace). As variantes em inglês
new workspaceenew namespacetambém são reconhecidas.
Os comandos fornecidos por plugins não são abrangidos por esta página.
Como funciona a filtragem
O texto introduzido é comparado como uma subcadeia, sem distinguir maiúsculas de minúsculas. Consoante a categoria, o Aperture verifica o título do ticket, a etiqueta ou o alias de uma vista, o nome e o caminho de um projeto, ou o nome de um espaço de trabalho ou de um namespace. Nos ficheiros, a pesquisa abrange também o conteúdo, após um breve compasso de espera; apenas são apresentados os doze primeiros resultados de ficheiros do âmbito escolhido.
Os resultados não recebem uma pontuação de relevância global. Mantêm uma ordem previsível: tickets, ficheiros, projetos, ações Git, vistas, espaços de trabalho e, por fim, namespaces. Dentro de cada secção, é mantida a ordem fornecida pelo Singularity. Quando o campo está vazio, o Aperture mostra primeiro os tickets e agentes ativos e, depois, os destinos disponíveis.
Tudo pelo teclado
Utiliza ↓ e ↑ para mover a seleção; esta volta ao início ou ao fim quando ultrapassas a lista. Prime Enter para ativar a linha selecionada e fechar o Aperture. Escape fecha a paleta sem executar qualquer ação.
Assim que escreves uma consulta, a primeira linha propõe enviá-la para a pesquisa completa do Singularity. Ativa-a com ⌘ Enter ou Ctrl Enter. Da abertura à seleção de um resultado, o Aperture pode ser utilizado inteiramente sem rato.
Atalhos rápidos
- Abrir um ficheiro: ⌘K, alguns caracteres do nome ou do conteúdo, ↓ até ao ficheiro e, depois, Enter.
- Saltar para um ticket: abre o Aperture, escreve um fragmento distintivo do título e confirma a linha que apresenta a respetiva referência.
- Abrir o cockpit Git: escreve
gitseguido do nome do projeto e confirma Git: nome-do-projeto. - Mudar de contexto: escreve o nome de um espaço de trabalho ou de um namespace em vez de voltares à navegação principal.