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

Grafo de conhecimento e links

As notas no Notarium são vinculadas manualmente — por meio de [[wiki-links]]. A partir desses links, o motor constrói um grafo de conhecimento: uma rede que mostra o que aponta para o quê e o que leva de volta à nota atual. O grafo é conhecimento derivado: ele é totalmente computado a partir do conteúdo dos seus arquivos e restaurado por uma reconstrução, de modo que a fonte da verdade não guarda nada além dos próprios arquivos .md.

Um link para outra nota é simplesmente [[Título da nota]] escrito no meio do texto. Você também pode adicionar um rótulo: [[Título da nota|como exibir]]. No modo de leitura, esse link é clicável:

Veja também [[Modelo de acesso]] e [[Busca híbrida|como a busca funciona]].
  • um clique leva você até a nota dentro do aplicativo;
  • um clique com modificador a abre em uma nova aba;
  • se não existir nenhuma nota com esse título, o Notarium se oferece para criá-la.

Os links são resolvidos por um nome estável, e não por um caminho na árvore, então mover ou renomear a nota de destino não quebra os [[links]] que levam até ela.

Um backlink é uma conexão de entrada: outra nota que aponta para a nota atual. O Notarium os calcula automaticamente — não há nada para marcar manualmente. O painel lateral de uma nota aberta reúne o entorno imediato dela: o grafo local ao seu redor, a lista de links de saída e de entrada, os metadados e o histórico de edições. Assim, a nota é lida não de forma isolada, mas no contexto de tudo o que está conectado a ela.

Nós fantasma

Você pode apontar um link para uma nota que ainda não existe — essa é uma forma normal de trabalhar de cima para baixo: primeiro esboçar as conexões, depois preenchê-las. Esses links para notas ainda não criadas aparecem no grafo como nós "fantasma" vazados.

Um nó fantasma é um ponto de crescimento

Clicar em um nó fantasma cria uma nota com esse título, e todos os links que levam até ela ficam "vivos" na hora. O grafo mostra quais notas estão faltando.

O grafo completo de um espaço é um mapa interativo com layout direcionado por forças (force-directed). A cor de cada nó é definida pela pasta ou pelo cluster de links, e o tamanho, pelo número de links e palavras. O painel do grafo oferece agrupamento, controle de densidade, filtros (por links, por links "mortos", por tags) e uma busca que foca em um nó selecionado. Veja Navegação para saber mais sobre como navegar pelo grafo.

O grafo de um espaço: a cor dos nós pela pasta, o tamanho pelo número de links

O grafo como sinal de busca

Os links não servem só para navegação. O Notarium usa o grafo de wiki-links como um sinal extra de ranqueamento na busca híbrida: para as notas que encontra, ele também traz os vizinhos mais próximos delas. Esse é um terceiro canal de busca, separado.

O graph boost na busca vem desligado por padrão

O canal de ranqueamento por grafo é ativado pela flag GRAPH_BOOST e vem desativado por padrão; ele não tem efeito se a busca semântica estiver desligada. Isso não afeta a navegação por links e pelo grafo em si — ela sempre funciona.

O grafo é construído dentro de um único espaço: cada espaço mantém seu próprio índice e grafo isolados. Não se formam links entre notas de espaços diferentes.

Tópicos relacionados: File-first — por que o grafo pode ser recuperado dos arquivos, Espaços e projetos — os limites do grafo, Busca híbrida — como os links entram no ranqueamento.