NotariumDocumentação
Versão da documentação: latest
PT

Busca e Spotlight

O Notarium tem duas superfícies de busca distintas, e vale a pena distingui-las desde o início. O Spotlight e o OmniSearch são de salto rápido (quick-jump): você digita parte de um título e vai direto para a nota que procura. O filtro por texto do Feed (?q=) é busca no corpus: ele restringe a lista de notas e se combina com filtros por pasta, tag e data. Em resumo: um é "saltar até uma nota", o outro é "filtrar a seleção".

Spotlight — saltar até uma nota

O Spotlight é um painel centralizado, comandado pelo teclado, que aparece sobre a página. Dá para abri-lo de três formas, e todas as três levam ao mesmo painel:

  • Cmd/Ctrl+P — o alternador rápido (Spotlight);
  • o ícone de busca na barra lateral esquerda;
  • a tecla de atalho /.
O layout do teclado não atrapalha

O painel escuta a tecla física, não o caractere. Num layout cirílico, Cmd/Ctrl+P (onde essa tecla física produz a letra cirílica ze) e / funcionam exatamente como num layout latino.

Como o painel se comporta:

  • Consulta vazia → "Recentes". Primeiro vêm as notas que você abriu recentemente (a lista é mantida por espaço), depois as recentemente modificadas completam. A primeira tarefa do alternador rápido é trazer você de volta para onde acabou de estar.
  • Digitar → notas. Cada tecla refina os resultados por busca híbrida (léxica + semântica onde a busca vetorial está ativada; um graph boost sobre os links é um canal extra, desativado por padrão; sem busca vetorial, a consulta recai na busca de texto completo — sem erro). As correspondências ficam destacadas no título e no trecho.
  • Cada linha de resultado mostra uma data e o caminho da pasta pai, para você distinguir notas que compartilham o mesmo nome.
  • Teclado: / para selecionar, Enter para abrir, Cmd/Ctrl+Enter para abrir numa nova aba, Esc para fechar.
Spotlight: correspondências realçadas, com a data e a pasta pai em cada linha de resultado

O Spotlight opera dentro do espaço ativo: ele busca notas no espaço atual.

OmniSearch — o campo da barra superior

O OmniSearch é o mesmo campo de busca, deslocado para o centro da barra superior em telas largas. Ele compartilha os dados de sugestão com o Spotlight: conforme você digita, os mesmos resultados de salto rápido surgem logo abaixo. A linha superior "buscar no Feed" (ou simplesmente Enter) entrega a consulta ao Feed como um filtro por texto ?q=.

O campo é uma conveniência para monitores grandes: em telas estreitas, ele fica totalmente oculto. Isso não representa perda de acesso — a busca está sempre a um gesto de distância pelo ícone da barra lateral, Cmd/Ctrl+P e /.

O filtro por texto do Feed

No Feed, a consulta q é um terceiro eixo de filtro ao lado das pastas e das tags: uma única linguagem de consulta, pasta ∧ tag ∧ texto. Aqui o que importa é a ocorrência dos termos, não a proximidade semântica: o filtro usa o canal de busca léxica (texto completo), então um "vizinho semântico" sem uma palavra em comum não entra na seleção. A consulta vive na URL (?q=), enquanto a janela do Feed, o contador exato total e o histograma por datas descrevem exatamente essa seleção restringida.

Para entender como a própria busca híbrida funciona por baixo dos panos, veja Busca. Os atalhos de teclado para abri-la estão na página Atalhos de teclado.