---

1 Instalação

1. Instalar a Obsidian - Descarregar e instalar a partir de obsidian.md
2. Ativar os plugins da comunidade - Vá a Definições → Plugins da comunidade → Ativar os plugins da comunidade
3. Instalar o Notebook Navigator - Clique em "Procurar" → Procure por "Notebook Navigator" → Instalar
4. Instalar as Definições de estilo (opcional) - Para personalizar as cores e o aspeto, instale o plugin Definições de estilo procurando "Definições de estilo" nos plugins da Comunidade

2 Introdução

Aqui está o tutorial oficial para aprender e dominar o Notebook Navigator:

O vídeo tem legendas em 21 línguas.

3 Segurança e qualidade

O Notebook Navigator é verificado com TypeScript, ESLint com o plugin oficial Obsidian ESLint, Prettier, Vitest e uma compilação de produção antes de as alterações serem integradas. A compilação deve ser concluída com zero erros e zero avisos.

As verificações de segurança são executadas através do CodeQL, com o histórico de verificações nas execuções do fluxo de trabalho do CodeQL e no OpenSSF Scorecard. O estado atual é mostrado nos emblemas na parte superior desta página.

O Notebook Navigator é executado localmente, mas algumas funcionalidades fazem pedidos HTTP documentados para actualizações, transferências e conteúdos remotos. Consulte a secção 10 - Divulgação de Rede e Diagnóstico para obter a lista completa.

Índice

• 4 Atalhos de teclado
• 5 Definições sincronizadas e locais
• 6 Pesquisa
• 7 Teclas de atalho personalizadas
• 8 Comandos
• 9 Caraterísticas
• 10 Divulgação de redes e diagnósticos
• 11 estrelas História
• 12 Contacto
• 13 Questões ou problemas?
• 14 Licença

4 Atalhos de teclado

Chave	Ação
↑/↓	Navegar para cima/para baixo no painel atual
←	No painel de navegação: recolher ou ir para o « » superior No painel de lista: alternar para o painel de navegação
→	No painel de navegação: expandir ou alternar para o painel de lista No painel de lista: alternar para o editor
Tab	No painel de navegação: alternar para o painel de lista No painel de lista: alternar para o editor No campo de pesquisa: alternar para o painel de lista
Shift+Tab	No painel de lista: alternar para o painel de navegação No campo de pesquisa: alternar para o painel de navegação
Enter (macOS) F2 (Windows/Linux)	Renomear um item diretamente no painel de navegação ou no painel de lista
Enter	No painel de navegação: abrir a nota da pasta no Windows/Linux por predefinição (quando ativado) No painel de lista: abrir o ficheiro selecionado em todos os sistemas (quando ativado) No campo de pesquisa: alternar para o painel de lista
Escape	No campo de pesquisa: fechar a pesquisa e colocar o foco no painel de lista
PageUp/PageDown	Deslocar-se para cima/para baixo no painel de navegação e no painel de lista
Home/End	Ir para o primeiro/último item no painel atual
Backspace	Apagar o item selecionado
Cmd/Ctrl+A	Selecionar todas as notas na pasta atual
Cmd/Ctrl+Clique	Alternar a seleção de notas
Shift+Clique	Selecionar um intervalo de notas
Shift+Home/End	Selecionar desde a posição atual até ao primeiro/último item
Shift+↑/↓	Alargar a seleção para cima/para baixo
Cmd/Ctrl+↑/↓	Reorganizar os ficheiros selecionados para cima/para baixo no modo de ordenação manual

Nota: Todos os atalhos de teclado podem ser personalizados. Consulte a secção 7 - Teclas de atalho personalizadas para obter detalhes sobre a adição de navegação ao estilo VIM (h,j,k,l), teclas alternativas e combinações de modificadores.

5 Definições sincronizadas e locais

Muitas definições no Notebook Navigator apresentam uma alternância de sincronização - um ícone de nuvem que alterna entre "Ativar sincronização" e "Desativar sincronização". Isto controla onde cada definição é armazenada e se é partilhada entre dispositivos.

5.1 Como funciona a sincronização

Os plugins da Obsidian armazenam a sua configuração em data.json, localizado em .obsidian/plugins/notebook-navigator/data.json dentro da sua pasta vault. Quando utiliza um serviço de sincronização - como o Obsidian Sync, iCloud, GitHub, Dropbox ou Google Drive - este ficheiro é sincronizado em todos os seus dispositivos juntamente com o resto do seu vault. Qualquer configuração salva em data.json será propagada para todos os dispositivos que sincronizarem o vault.

Quando a sincronização está activada (predefinição) para uma definição, o valor é guardado em data.json e sincronizado para todos os dispositivos através do seu serviço de sincronização.

Quando a sincronização está desactivada para uma definição, o valor é guardado no armazenamento local da Obsidian. O armazenamento local é específico do dispositivo e não está incluído na sincronização do cofre. A definição terá o seu próprio valor independente em cada dispositivo. Quando desativar a sincronização de uma definição, o valor atual é copiado para o armazenamento local no dispositivo atual e o valor é removido de data.json para evitar que se sobreponha aos valores locais noutros dispositivos.

Se não utilizar um serviço de sincronização, a opção de sincronização não tem qualquer efeito prático, uma vez que data.json só é armazenado localmente.

6 Pesquisa

O Notebook Navigator tem dois modos de pesquisa: pesquisa com filtro e Omnisearch. Alterne entre eles utilizando as teclas de seta para cima/para baixo ou clicando no ícone de pesquisa. Combine nomes de ficheiros, propriedades, etiquetas, datas e filtros numa única consulta (por exemplo, meeting .status=active #work @thisweek).

6.1 Filtrar a pesquisa

Filtra ficheiros por nome, etiquetas, propriedades, datas, pastas, extensões e tarefas dentro da pasta e subpastas actuais. Modo de pesquisa predefinido.

Nomes de ficheiros

• word - Corresponder notas com "palavra" no nome do ficheiro
• word1 word2 - Exigir que cada palavra corresponda ao nome do ficheiro
• -word - Excluir notas com "palavra" no nome do ficheiro

Etiquetas

• #tag - Incluir notas com etiqueta (também corresponde a etiquetas aninhadas como #tag/subtag)
• # - Incluir apenas notas marcadas
• -#tag - Excluir notas com etiqueta
• -# - Incluir apenas notas não marcadas
• #tag1 #tag2 - Corresponder a ambas as etiquetas (AND implícito)
• #tag1 AND #tag2 - Corresponder ambas as etiquetas (AND explícito)
• #tag1 OR #tag2 - Corresponder a qualquer etiqueta
• #a OR #b AND #c - AND tem precedência mais elevada: corresponde a #a, ou a ambos #b e #c
• Cmd/Ctrl+Clique numa etiqueta para adicionar com AND. Cmd/Ctrl+Shift+Clique para adicionar com OU

Propriedades

• .key - Incluir notas com a chave do imóvel
• .key=value - Incluir notas onde o valor da propriedade contém value
• ."Reading Status" - Chave de propriedade com espaço em branco (aspas duplas)
• ."Reading Status"="In Progress" - As chaves e os valores com espaços em branco devem estar entre aspas duplas
• -.key - Excluir notas com chave de propriedade
• -.key=value - Excluir notas em que o valor do imóvel contém value
• Cmd/Ctrl+Clique numa propriedade para adicionar com AND. Cmd/Ctrl+Shift+Clique para adicionar com OR

Filtros

• has:task - Incluir notas com tarefas inacabadas
• -has:task - Excluir notas com tarefas inacabadas
• folder:meetings - Incluir notas quando o nome de uma pasta contém meetings
• folder:/work/meetings - Incluir notas apenas em work/meetings (não em subpastas)
• folder:/ - Incluir notas apenas na raiz da abóbada
• -folder:archive - Excluir notas em que o nome de uma pasta contém archive
• -folder:/archive - Excluir notas apenas em archive (não em subpastas)
• ext:md - Incluir notas com a extensão md (ext:.md também é suportado)
• -ext:pdf - Excluir notas com extensão pdf
• Combinar com etiquetas, nomes e datas (por exemplo, folder:/work/meetings ext:md @thisweek)

Datas

• @today - Corresponder notas de hoje utilizando o campo de data predefinido
• @yesterday, @last7d, @last30d, @thisweek, @thismonth - Intervalos de datas relativos
• @2026-02-07 - Corresponder a um único dia (também suporta @20260207)
• @2026 - Corresponder a um ano civil
• @2026-02 ou @202602 - Corresponde a um mês de calendário
• @2026-W05 ou @2026W05 - Corresponder a uma semana ISO
• @2026-Q2 ou @2026Q2 - Corresponde a um trimestre civil
• @13/02/2026 - Formatos numéricos com separadores (@07022026 segue a sua localidade quando ambíguo)
• @2026-02-01..2026-02-07 - Corresponder a uma gama de dias inclusiva (aceita-se fins abertos)
• @c:... ou @m:... - Data de criação ou modificação do destino
• -@... - Excluir uma correspondência de data

O campo de data predefinido segue a ordem de ordenação atual. Ao ordenar por nome, o campo de data é configurado em Definições → Notas → Data → Ao ordenar por nome.

Comportamento AND/OR

AND e OR funcionam em consultas apenas de etiquetas/propriedades (consultas que contêm apenas filtros #tag, -#tag, #, -#, .key, -.key, .key=value, ou -.key=value ). Se a consulta também incluir nomes, datas, filtros de tarefa, filtros de pasta ou filtros de extensão, AND e OR são correspondidos como palavras de nome de ficheiro.

• Consulta do operador: #work OR .status=started
• Consulta mista: #work OR ext:md (OR é correspondido em nomes de ficheiros)

6.2 Omnisearch

Pesquisa de texto completo no vault, filtrada para a pasta atual, subpastas ou etiquetas selecionadas. Requer o plug-in Omnisearch. Se o Omnisearch não estiver instalado, a pesquisa volta para a pesquisa com filtro.

As pré-visualizações de notas mostram excertos de resultados do Omnisearch em vez do texto de pré-visualização predefinido.

Limitações conhecidas

• Desempenho - Pode ser lento quando se procura menos de 3 caracteres em cofres grandes
• Filtros de caminho — O âmbito da pasta é enviado para o Omnisearch apenas no caso de caminhos ASCII simples. Os outros caminhos são filtrados depois de o Omnisearch devolver os resultados
• Resultados limitados - O Omnisearch pesquisa todo o cofre e devolve um número limitado de resultados antes de filtrar, pelo que os ficheiros relevantes da pasta atual podem não aparecer se existirem muitas correspondências noutro local
• Pré-visualização detexto - As pré-visualizações de notas são substituídas por excertos de resultados do Omnisearch, que podem não mostrar o realce da correspondência de pesquisa se esta aparecer noutro local do ficheiro

7 Teclas de atalho personalizadas

Edite .obsidian/plugins/notebook-navigator/data.json para personalizar as teclas de atalho do Navegador do Notebook. Abra o ficheiro e localize a secção keyboardShortcuts. Cada entrada mapeia uma ação para uma ou mais ligações de teclas:

"pane:move-up": [ { "key": "ArrowUp", "modifiers": [] }, { "key": "K", "modifiers": [] } ]

Adicione várias ligações por ação para suportar chaves alternativas, como o exemplo ArrowUp e K acima. Combine modificadores numa entrada, listando cada valor, por exemplo "modifiers": ["Mod", "Shift"]. Sequências de teclado como gg ou dd não são suportadas. Recarregue a Obsidian depois de editar o ficheiro.

7.1 Modificadores

Modificador	Tecla
Mod	Cmd (macOS) / Ctrl (Win/Linux)
Alt	Alt / Opção
Shift	Shift
Ctrl	Controlo (preferir Mod para todas as plataformas)

7.2 Acções disponíveis

Ação	Tecla(s) predefinida(s)
pane:move-up	Seta para cima
pane:move-down	Seta para baixo
pane:page-up	Página para cima
pane:page-down	Página para baixo
pane:home	Início
pane:end	Fim
pane:rename	Enter (macOS), F2 (Windows/Linux)
pane:delete-selected	Delete, Backspace
navigation:collapse-or-parent	Seta para a esquerda
navigation:expand-or-focus-list	Seta para a direita
navigation:focus-list	Tab
list:focus-navigation	Seta para a esquerda, Shift+Tab
list:focus-editor	Seta para a direita, Tab
list:select-all	Mod+A
list:extend-selection-up	Shift+Seta para cima
list:extend-selection-down	Shift+Seta para baixo
list:manual-sort-up	Mod+Seta para cima
list:manual-sort-down	Mod+Seta para baixo
list:range-to-start	Shift+Home
list:range-to-end	Shift+End
search:focus-list	Tab, Enter
search:focus-navigation	Shift+Tab
search:close	Esc

8 Comandos

Define teclas de atalho personalizadas para estes comandos nas definições de teclas de atalho da Obsidian:

Ver e navegar

• Notebook Navigator: Open Abre o Navegador de Notebook na barra lateral esquerda. Se já estiver aberto, move o foco do teclado para o painel de lista. Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+E para mover o foco do teclado para o painel da lista - isto é essencial para uma navegação completa no teclado
• Notebook Navigator: Toggle left sidebar Alterna a barra lateral esquerda. Ao abrir, define a vista da barra lateral esquerda para o Notebook Navigator (ao contrário do comando "Toggle left sidebar" incorporado na Obsidian, que restaura a vista anterior da barra lateral esquerda)
• Notebook Navigator: Open homepage Abre a vista do Notebook Navigator e carrega o destino da página inicial configurado nas definições
• Notebook Navigator: Select vault profile Abre um modal para alternar entre perfis de cofre
• Notebook Navigator: Reveal file Revela o ficheiro atual no navegador. Expande as pastas principais e desloca-se para o ficheiro. Este comando é útil se tiver a definição Auto-reveal active note desactivada e quiser revelar notas manualmente. Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+R para mudar rapidamente a pasta ou etiqueta selecionada para o ficheiro atual
• Notebook Navigator: Open all files Abre todas as notas na pasta ou etiqueta atualmente selecionada. Ao abrir 15 ou mais ficheiros, mostra uma caixa de diálogo de confirmação
• Notebook Navigator: Navigate to folder Caixa de diálogo de pesquisa para saltar para qualquer pasta
• Notebook Navigator: Navigate to tag Diálogo de pesquisa para saltar para qualquer etiqueta
• Notebook Navigator: Navigate to property Diálogo de pesquisa para saltar para qualquer chave ou valor de propriedade
• Notebook Navigator: Navigate back Move-se para a pasta, etiqueta ou seleção de propriedade anterior no histórico do navegador
• Notebook Navigator: Navigate forward Passa para a pasta, etiqueta ou seleção de propriedade seguinte no histórico do navegador
• Notebook Navigator: Add to shortcuts Adiciona ou remove o ficheiro, pasta, etiqueta ou propriedade atual dos atalhos
• Notebook Navigator: Open shortcut 1-9 Abre o atalho pela sua posição na lista de atalhos
• Notebook Navigator: Search Abre o campo de pesquisa rápida ou foca-o se já estiver aberto. A pesquisa mantém-se entre sessões. Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+S para filtragem rápida de ficheiros
• Notebook Navigator: Search whole vault Seleciona a pasta raiz do cofre e abre a pesquisa incluindo as subpastas (requer que a opção « Show root folder » esteja ativada)

Seleção

• Notebook Navigator: Select next file Move a seleção para o ficheiro seguinte na pasta atual ou na vista de etiquetas. Respeita a ordem de classificação personalizada. Sugestão: Associar a uma tecla de atalho como Option+Cmd+Right para ir rapidamente para o ficheiro seguinte na lista
• Notebook Navigator: Select previous file Move a seleção para o ficheiro anterior na pasta atual ou na vista de etiquetas. Respeita a ordem de classificação personalizada. Sugestão: Associar a uma tecla de atalho como Option+Cmd+Left para ir rapidamente para o ficheiro anterior na lista

Disposição e visualização

• Notebook Navigator: Toggle dual pane layout Alternar a disposição de painel único/duplo (ambiente de trabalho). Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+A para alternar rapidamente entre a disposição de painel único e de painel duplo
• Notebook Navigator: Toggle dual pane orientation Alternar a orientação do painel duplo entre horizontal e vertical
• Notebook Navigator: Toggle descendants Alternar a apresentação de notas de subpastas / descendentes para pastas e etiquetas. Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+D para alternar rapidamente a visualização de notas de subpastas / descendentes
• Notebook Navigator: Toggle hidden folders, tags, and notes Mostrar ou ocultar pastas, etiquetas e notas ocultas
• Notebook Navigator: Toggle tag sort order Alternar entre a ordenação das etiquetas por ordem alfabética e por frequência
• Notebook Navigator: Toggle tags by selection Alternar a limitação de etiquetas para as encontradas em notas dentro da pasta ou propriedade selecionada
• Notebook Navigator: Toggle properties by selection Alternar a limitação de propriedades para as encontradas em notas dentro da pasta ou etiqueta selecionada
• Notebook Navigator: Toggle compact mode Alternar o modo de lista entre padrão e compacto
• Notebook Navigator: Toggle pinned section Mostrar ou ocultar notas fixas no painel de lista
• Notebook Navigator: Collapse / expand all items Recolher ou expandir todos os itens com base no estado atual. Quando Keep selected item expanded está ativado (predefinição: ligado), todas as pastas, exceto a atual, serão recolhidas. Isto é útil para manter a árvore de navegação organizada ao procurar documentos
• Notebook Navigator: Collapse / expand selected item Recolher ou expandir o item de navegação selecionado

Calendário

• Notebook Navigator: Toggle calendar Liga ou desliga o calendário. Sugestão: Associar a uma tecla de atalho como Cmd/Ctrl+Shift+C para mostrar rapidamente o calendário
• Notebook Navigator: Open daily note Abre a nota diária de hoje com base nas configurações do calendário. Cria a nota se ela não existir
• Notebook Navigator: Open weekly note Abre a nota semanal atual. Cria a nota se ela não existir
• Notebook Navigator: Open monthly note Abre a nota mensal atual. Cria a nota se ela não existir
• Notebook Navigator: Open quarterly note Abre a nota trimestral atual. Cria a nota se ela não existir
• Notebook Navigator: Open yearly note Abre a nota anual atual. Cria a nota se ela não existir

Operações de ficheiros

Importante: A Obsidian não tem um contexto de "pasta ou etiqueta atual", por isso, ao criar notas na Obsidian, por defeito, estas são criadas na pasta raiz, na mesma pasta do ficheiro atual ou numa pasta específica. Quando trabalha com o Notebook Navigator, quer sempre criar novas notas na pasta ou etiqueta atualmente selecionada, por isso a primeira coisa a fazer é associar Cmd/Ctrl+N a Notebook Navigator: Create new note para que as novas notas sejam sempre criadas na pasta ou etiqueta atualmente selecionada. O mesmo se aplica à movimentação e eliminação de ficheiros. É por isso que deve utilizar estes comandos em vez dos comandos integrados da Obsidian quando utilizar o Notebook Navigator.

• Notebook Navigator: Create new note Criar nota na pasta atualmente selecionada. Sugestão: Ligar Cmd/Ctrl+N a este comando (primeiro, desvincular do comando predefinido da Obsidian "Criar nova nota")
• Notebook Navigator: Create new note from template Criar nota a partir do modelo na pasta atualmente selecionada (requer o Templater)
• Notebook Navigator: Move files Mover os ficheiros selecionados para outra pasta. Seleciona o ficheiro seguinte na pasta atual
• Notebook Navigator: Merge notes Criar uma nota a partir de notas Markdown selecionadas na ordem da lista atual
• Notebook Navigator: Convert to folder note Crie uma pasta com o nome do ficheiro e mova o ficheiro para o seu interior como nota da pasta
• Notebook Navigator: Set as folder note Mudar o nome do ficheiro ativo para o nome da nota da pasta
• Notebook Navigator: Detach folder note Retirar a nota da pasta na pasta selecionada e mudar-lhe o nome
• Notebook Navigator: Pin all folder notes Fixar todas as notas das pastas em todas as pastas. O comando só fica visível quando as notas das pastas estão ativadas
• Notebook Navigator: Delete files Eliminar ficheiros selecionados. Seleciona o ficheiro seguinte na pasta atual

Operações de etiquetagem

• Notebook Navigator: Add tag to selected files Caixa de diálogo para adicionar etiquetas aos ficheiros selecionados. Suporta a criação de novas etiquetas
• Notebook Navigator: Set property on selected files Caixa de diálogo para definir propriedades nos ficheiros selecionados
• Notebook Navigator: Remove tag from selected files Diálogo para remover uma etiqueta específica. Remove imediatamente se apenas uma etiqueta
• Notebook Navigator: Remove all tags from selected files Limpar todas as etiquetas dos ficheiros selecionados com confirmação

Manutenção

• Notebook Navigator: Rebuild cache Reconstrói a cache local do Notebook Navigator. Utilize esta opção se tiver etiquetas em falta, pré-visualizações incorrectas ou imagens de funcionalidades em falta

8.1 IDs de comando

ID do comando	Nome do comando
notebook-navigator:open	Navegador do Bloco de Notas: Abrir
notebook-navigator:toggle-left-sidebar	Navegador do bloco de notas: Alternar barra lateral esquerda
notebook-navigator:open-homepage	Navegador do bloco de notas: Abrir página inicial
notebook-navigator:select-profile	Navegador do bloco de notas: Selecionar perfil do cofre
notebook-navigator:select-profile-1	Navegador do Notebook: Selecionar perfil do cofre 1
notebook-navigator:select-profile-2	Navegador do bloco de notas: Selecionar perfil do cofre 2
notebook-navigator:select-profile-3	Navegador do bloco de notas: Selecionar perfil do cofre 3
notebook-navigator:reveal-file	Navegador do bloco de notas: Revelar ficheiro
notebook-navigator:open-all-files	Navegador do bloco de notas: Abrir todos os ficheiros
notebook-navigator:navigate-to-folder	Navegador do Bloco de Notas: Navegar até à pasta
notebook-navigator:navigate-to-tag	Navegador do bloco de notas: Navegar até à etiqueta
notebook-navigator:navigate-to-property	Navegador do Caderno: Navegar até à propriedade
notebook-navigator:navigate-back	Navegador do Bloco de Notas: Voltar
notebook-navigator:navigate-forward	Navegador do Bloco de Notas: Avançar
notebook-navigator:add-shortcut	Navegador do Bloco de Notas: Adicionar aos atalhos
notebook-navigator:open-shortcut-1	Navegador do Bloco de Notas: Abrir atalho 1
notebook-navigator:open-shortcut-2	Navegador do Bloco de Notas: Abrir atalho 2
notebook-navigator:open-shortcut-3	Navegador do Bloco de Notas: Abrir atalho 3
notebook-navigator:open-shortcut-4	Navegador do Bloco de Notas: Abrir atalho 4
notebook-navigator:open-shortcut-5	Navegador do Bloco de Notas: Abrir atalho 5
notebook-navigator:open-shortcut-6	Navegador do Bloco de Notas: Abrir atalho 6
notebook-navigator:open-shortcut-7	Navegador do Bloco de Notas: Abrir atalho 7
notebook-navigator:open-shortcut-8	Navegador do Bloco de Notas: Abrir atalho 8
notebook-navigator:open-shortcut-9	Navegador de cadernos: Abrir atalho 9
notebook-navigator:search	Navegador do Bloco de Notas: Pesquisar
notebook-navigator:search-vault	Navegador do Bloco de Notas: Pesquisar em todo o cofre
notebook-navigator:toggle-dual-pane	Navegador do Bloco de Notas: Alternar entre o layout de painel duplo
notebook-navigator:toggle-dual-pane-orientation	Navegador do Bloco de Notas: Alternar a orientação do painel duplo
notebook-navigator:toggle-calendar	Navegador do Caderno: Alternar calendário
notebook-navigator:open-daily-note	Navegador do Caderno: Abrir nota diária
notebook-navigator:open-weekly-note	Navegador do Caderno: Abrir nota semanal
notebook-navigator:open-monthly-note	Navegador do Bloco de Notas: Abrir nota mensal
notebook-navigator:open-quarterly-note	Navegador do Caderno: Abrir nota trimestral
notebook-navigator:open-yearly-note	Navegador do Caderno: Abrir nota anual
notebook-navigator:toggle-descendants	Navegador do Bloco de Notas: Alternar descendentes
notebook-navigator:toggle-hidden	Navegador do Caderno: Alternar entre pastas, etiquetas e notas ocultas
notebook-navigator:toggle-tag-sort	Navegador do Caderno: Alternar a ordem de classificação das etiquetas
notebook-navigator:toggle-tags-by-selection	Navegador do Bloco de Notas: Alternar entre etiquetas por seleção
notebook-navigator:toggle-properties-by-selection	Navegador do Bloco de Notas: Alternar propriedades por seleção
notebook-navigator:toggle-compact-mode	Navegador do Bloco de Notas: Alternar para o modo compacto
notebook-navigator:toggle-pinned-section	Navegador do Bloco de Notas: Alternar secção fixada
notebook-navigator:collapse-expand	Navegador do Bloco de Notas: Recolher/expandir todos os itens
notebook-navigator:collapse-expand-selected-item	Navegador do Bloco de Notas: Recolher/expandir o item selecionado
notebook-navigator:new-note	Navegador do Bloco de Notas: Criar nova nota
notebook-navigator:new-note-from-template	Navegador do Bloco de Notas: Criar nova nota a partir de um modelo
notebook-navigator:move-files	Navegador do Bloco de Notas: Mover ficheiros
notebook-navigator:merge-notes	Navegador do Bloco de Notas: Juntar notas
notebook-navigator:select-next-file	Navegador do Bloco de Notas: Selecionar o ficheiro seguinte
notebook-navigator:select-previous-file	Navegador do Bloco de Notas: Selecionar ficheiro anterior
notebook-navigator:convert-to-folder-note	Navegador do Caderno: Converter em nota de pasta
notebook-navigator:set-as-folder-note	Navegador do Bloco de Notas: Definir como nota de pasta
notebook-navigator:detach-folder-note	Navegador do Bloco de Notas: Desanexar nota de pasta
notebook-navigator:pin-all-folder-notes	Navegador do Bloco de Notas: Fixar todas as notas de pasta
notebook-navigator:delete-files	Navegador do Bloco de Notas: Eliminar ficheiros
notebook-navigator:add-tag	Navegador do Bloco de Notas: Adicionar etiqueta aos ficheiros selecionados
notebook-navigator:set-property	Navegador do Bloco de Notas: Definir propriedade nos ficheiros selecionados
notebook-navigator:remove-tag	Navegador do Bloco de Notas: Remover etiqueta dos ficheiros selecionados
notebook-navigator:remove-all-tags	Navegador do Bloco de Notas: Remover todas as etiquetas dos ficheiros selecionados
notebook-navigator:rebuild-cache	Navegador do Caderno: Recriar a cache

9 Caraterísticas

9.1 Interface

• Layout de painel duplo - painel de navegação (pastas/etiquetas/propriedades) e painel de lista (ficheiros)
• Modo de painel único - Vistas de navegação e de lista com transições animadas
• Painéis redimensionáveis - Orientação dividida horizontal ou vertical
• Zoom independente da IU - Dimensione o Navegador do Notebook sem alterar o zoom da Obsidian
• Vista de arranque - Navegação em primeiro lugar ou lista em primeiro lugar
• Suporte multilingue - 21 idiomas com suporte de layout RTL
• Conjunto de ícones da interface - ícones personalizáveis da interface do utilizador em todo o plug-in

9.2 Navegação

• Perfis de cofre - Várias visualizações filtradas com pastas/etiquetas/notas ocultas por perfil, visibilidade de ficheiros, banner e atalhos
• Atalhos - Notas, pastas, etiquetas, propriedades e pesquisas guardadas, com a possibilidade de fixar e reordenar
• Notas/ficheiros recentes - Secção de itens recentes armazenados por perfil do cofre, opcionalmente fixados com atalhos
• Calendário - Calendário de notas diárias com seleção de dias, pré-visualizações de imagens e suporte para divisão vertical
• Árvore de pastas - Navegação expandir/recolher com ordenação manual da pasta raiz
• Árvore de tags - Tags hierárquicas com ordenação configurável da tag raiz
• Navegador de propriedades - Navegue pelas propriedades dos ficheiros organizadas por chave e valor com contagens de ficheiros, cores personalizadas, ícones e arrastar e largar
• Revelaçãoautomática do ficheiro ativo - Expansão da pasta e deslocação para a seleção
• Teclado e comandos - Teclas de atalho configuráveis, comandos de retrocesso/avanço do histórico de seleção, comandos de ficheiro seguinte/anterior, comandos de atalho de abertura 1-9

9.3 Organização

• Notas fixas - Mantenha as notas importantes na parte superior das pastas e etiquetas
• Notas de pasta - Definir/remover notas de pasta, fixar notas de pasta, opção de abrir num novo separador
• Operações com etiquetas - Adicionar/remover/limpar etiquetas, renomear/eliminar etiquetas, criar nota na etiqueta, arrastar e largar hierarquia de etiquetas
• Ordenaçãoe agrupamento personalizados - Substituir as definições de ordenação/agrupamento por pasta ou etiqueta
• Aparências por pasta/identificador - Linhas de título, linhas de pré-visualização, modo compacto, alternância de descendentes
• Conteúdo oculto - Pastas/marcas/notas/ficheiros ocultos com padrões, propriedades de frontmatter e filtragem baseada em marcas por perfil de cofre
• Excluir pastas dos subpastas - Omitir pastas ao recolher notas das subpastas, de acordo com o perfil do cofre; as pastas excluídas permanecem visíveis e mostram as suas notas quando selecionadas
• Sistema de cores e ícones - Cores de pastas/identificadores/propriedades/ficheiros, pacotes de ícones, ícones emoji/Lucide, leitura/escrita do frontmatter, mapeamento de ícones por nome de ficheiro e categoria de tipo de ficheiro
• Avisos de nomes - Avisa sobre caracteres proibidos do sistema de ficheiros e caracteres que quebram as ligações da Obsidian ao nomear ficheiros e pastas

9.4 Visualização de ficheiros

• Pré-visualizações de notas - 1-5 linhas de pré-visualização com remoção opcional de HTML
• Miniaturas - Imagens em destaque e miniaturas geradas automaticamente para ficheiros PDF, SVG e de desenho armazenados na cache de metadados
• Imagens externas - Transferências opcionais para imagens externas e miniaturas do YouTube
• Agrupamento de datas - Agrupar notas por Hoje, Ontem, 7 dias anteriores, 30 dias anteriores, meses e anos quando ordenadas por data
• Suporte de frontmatter - Ler nomes de notas e carimbos de data/hora de campos de frontmatter
• Anotar metadados - Mostrar data de modificação e etiquetas na lista de ficheiros
• Propriedades personalizadas - Mostrar propriedades do frontmatter ou contagem de palavras na lista de ficheiros com substituições por pasta/identificador e cores personalizadas
• Apresentação da pasta principal - Nome e ícone opcionais da pasta principal na lista de ficheiros
• Modo compacto - Ecrã compacto quando a pré-visualização, a data e as imagens estão desactivadas
• Etiquetasclicáveis - As etiquetas na lista de ficheiros permitem navegar diretamente para essa etiqueta

9.5 Produtividade

• Pesquisa - Filtrar por nome de ficheiro, etiquetas, propriedades, datas, pastas, extensões e tarefas com E/OU/exclusões
• Integração Omnisearch - Pesquisa de texto completo através do Omnisearch
• Arrastar e largar - Movimentos de ficheiros, etiquetagem, atribuição de atalhos, repartição da árvore de etiquetas, pastas carregadas por mola
• Menus de contexto - Criar notas/pastas/canvas/bases/desenhos e executar acções de ficheiros/etiquetas
• Desenhos - Criar desenhos Excalidraw e Tldraw a partir dos menus de navegação e do painel de listas
• Modelos - Nova nota de comandos de modelos com o plugin Templater
• Operações com ficheiros - Criar, mudar o nome, duplicar, mover, eliminar ficheiros e pastas
• Filtragem - Exclusões de pastas/identificadores/notas/ficheiros com padrões e propriedades de frontmatter

10 Divulgação de redes e diagnósticos

O Notebook Navigator é executado localmente, mas algumas funcionalidades fazem pedidos HTTP à Obsidian. O registo de depuração de arranque também pode escrever um ficheiro de diagnóstico local no seu vault.

10.1 Verificações de atualização da versão (opcional)

• Definição: "Verificar se há uma nova versão ao iniciar"
• Pedido: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
• Frequência: No máximo uma vez por 24 horas, no arranque
• Dados: Envia metadados HTTP padrão; não inclui conteúdo do cofre

10.2 descarregamentos de pacotes de ícones (opcional)

• Definição: Ativar um pacote de ícones no separador Pacotes de ícones
• Pedidos: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (manifesto, tipo de letra, metadados)
• Armazenamento: Armazenado localmente em IndexedDB

10.3 Imagens externas, vídeos e miniaturas do YouTube

• Imagens de recursos (Opcional): Controlado pela definição "Descarregar imagens externas". Descarrega imagens remotas e miniaturas do YouTube para imagens de recursos e armazena-as localmente no IndexedDB.
• Modal de boas-vindas (Primeiro lançamento): Carrega uma miniatura estática de https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
• Modal Novidades (Na atualização / quando aberto): Carrega imagens de banner de versão de https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg para notas de versão que incluem um banner.
• Modal «Novidades» (ao atualizar / ao abrir): Carrega vídeos de lançamento a partir de https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 para notas de lançamento que incluam um vídeo.
• Janela modal «Novidades» (ao abrir um vídeo de lançamento): Abre vídeos de lançamento a partir de https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4 para que os navegadores possam reproduzir o vídeo diretamente.
• Modal Novidades (Na atualização / quando aberto): Carrega miniaturas do YouTube a partir de https://img.youtube.com/vi/<id>/... para notas de versão que incluem um link do YouTube.

10.4 Ficheiros de depuração de arranque (opcional)

• Definição: "Registo de depuração de arranque"
• Armazenamento: Grava um arquivo nn-debug-...md com carimbo de data e hora na raiz do vault e pára depois que a inicialização se estabiliza. O ficheiro pode ser sincronizado se a raiz do vault estiver sincronizada.
• Dados: Inclui tempo de inicialização, versão do plug-in, versão mínima suportada da Obsidian, plataforma, contagens de cache, contagens de fila, status do IndexedDB e erros de diagnóstico. Não inclui o conteúdo das notas, nomes de etiquetas, valores do frontmatter ou uma lista de ficheiros do vault.
• Caminhos e identificadores: A inicialização do arranque, os diagnósticos de PDF e os casos de erro podem incluir o identificador da aplicação Obsidian/vault, caminhos de PDF relativos ao vault ou detalhes da pilha de erros. Reveja e edite o ficheiro antes de o partilhar publicamente.
• Carregar: O Notebook Navigator não carrega ficheiros de depuração. Estes só são partilhados se os carregar, anexar ou sincronizar fora do plug-in.

10.5 Privacidade e tratamento de dados

• O Notebook Navigator não envia conteúdo de notas, nomes de ficheiros, etiquetas ou ficheiros de depuração para um servidor do Notebook Navigator.
• Os pedidos ao GitHub, ao YouTube e a qualquer anfitrião de imagens externo são efectuados diretamente a partir do seu dispositivo e incluem metadados HTTP padrão (endereço IP, agente do utilizador e similares).
• Os pacotes de ícones e imagens descarregados são armazenados localmente (IndexedDB). As notas/ficheiros recentes e o estado da IU são armazenados localmente (armazenamento local Obsidian).

11 estrelas História

12 Contacto

O Notebook Navigator foi criado e é mantido por Johan Sanneblad. Johan tem um doutoramento em Desenvolvimento de Software e trabalhou no desenvolvimento de inovação para empresas como a Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group e Yamaha.

Não hesite em contactar comigo no LinkedIn.

13 Questões ou problemas?

Junte-se ao nosso Discord para suporte e discussões, ou abra um problema norepositório do GitHub.

Não são aceites pull requests. Com o surgimento da programação agênica, não é possível garantir que o código enviado por terceiros cumpra os padrões de qualidade do projeto, pelo que qualquer pull request é encerrado automaticamente. Em vez disso, contribua com ideias sob a forma de pedidos de funcionalidades — abra um issue. Consulte o ficheiro CONTRIBUTING.md para mais detalhes.

14 Licença

Este projeto está licenciado sob a GNU General Public License v3.0 - veja o ficheiro LICENSE para mais detalhes.