Índice da documentação

// 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.

Paleta Aperture aberta no Singularity com uma pesquisa e várias categorias de resultados
Uma única consulta faz surgir as ações e os elementos úteis do workbench.

O que lá encontras

Os comandos nativos estão agrupados por utilização:

  • Vistas: Mission Control, Terminal, Editor, Git, Marketplace e Settings. Experimenta terminal, editor ou settings: 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-commands ou um fragmento de código como openProjectGit.
  • Tickets: o título, a referência e o projeto. Uma pesquisa como documentation encontra os tickets cujo título contém esse texto.
  • Projetos e Git: o nome ou o caminho do projeto; git Singularity abre 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 workspace e new namespace també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

  1. Abrir um ficheiro: ⌘K, alguns caracteres do nome ou do conteúdo, ↓ até ao ficheiro e, depois, Enter.
  2. Saltar para um ticket: abre o Aperture, escreve um fragmento distintivo do título e confirma a linha que apresenta a respetiva referência.
  3. Abrir o cockpit Git: escreve git seguido do nome do projeto e confirma Git: nome-do-projeto.
  4. Mudar de contexto: escreve o nome de um espaço de trabalho ou de um namespace em vez de voltares à navegação principal.