Indice della documentazione

Documentazione principale

Documentazione per gli sviluppatori

  • Riferimento API - Documentazione API pubblica. Copre la gestione dei metadati, il controllo della navigazione e le sottoscrizioni agli eventi per gli sviluppatori JavaScript/TypeScript.
  • Guida alla tematizzazione - Guida per gli sviluppatori di temi. Include riferimenti alle classi CSS, proprietà personalizzate ed esempi di temi per le modalità chiara e scura.
  • Processo di avvio - Sequenza di inizializzazione dei plugin. Flussi di avvio a freddo o a caldo, risoluzione della cache dei metadati, pulizia differita e pipeline di generazione dei contenuti. Include diagrammi Mermaid.
  • Pipeline dei metadati - Sequenza di ricostruzione della cache, fasi della pipeline dei provider e segnali di completamento. Include diagrammi Mermaid.
  • Architettura di archiviazione - Guida ai contenitori di storage (IndexedDB, Local Storage, Memory Cache, Impostazioni). Modelli di flusso dei dati e linee guida di utilizzo.
  • Architettura di rendering - Gerarchia dei componenti React, scorrimento virtuale con TanStack Virtual, ottimizzazioni delle prestazioni e flusso di dati.
  • Orchestrazione dello scorrimento - Come il plugin assicura uno scorrimento accurato quando le strutture dell'albero cambiano (visibilità dei tag, impostazioni, ecc.)
  • Architettura dei servizi - Livello di logica aziendale: MetadataService, FileSystemOperations, ContentProviderRegistry. Modelli di iniezione delle dipendenze e flusso di dati del servizio.

1 Installazione

  1. Installare Obsidian - Scaricare e installare da obsidian.md
  2. Attivare i plugin della comunità - Andare in Impostazioni → Plugin della comunità → Attivare i plugin della comunità
  3. Installare Notebook Navigator - Fare clic su "Sfoglia" → Cercare "Notebook Navigator" → Installare
  4. Installare le Impostazioni di stile (opzionale) - Per personalizzare i colori e l'aspetto, installare il plugin Impostazioni di stile cercando "Impostazioni di stile" nei plugin della Comunità

2 Per iniziare

Ecco il tutorial ufficiale per imparare e padroneggiare Notebook Navigator:

Mastering Notebook Navigator

Il video è sottotitolato in 21 lingue.


3 Sicurezza e qualità

Notebook Navigator viene controllato con TypeScript, ESLint con il plugin ufficiale di Obsidian ESLint, Prettier, Vitest e una build di produzione prima che le modifiche vengano unite. La compilazione deve essere completata con zero errori e zero avvertimenti.

I controlli di sicurezza vengono eseguiti tramite CodeQL, con la cronologia delle scansioni nei flussi di lavoro di CodeQL e nella Scorecard di OpenSSF. Lo stato attuale è mostrato nei badge in cima a questa pagina.

Notebook Navigator viene eseguito localmente, ma alcune funzioni effettuano richieste HTTP documentate per aggiornamenti, download e contenuti remoti. Per l'elenco completo, consultare la sezione 10 - Divulgazione della rete e della diagnostica.


Indice dei contenuti


4 Scorciatoie da tastiera

Legenda Azione
↑/↓ Spostarsi verso l'alto/verso il basso nel riquadro corrente
Nel riquadro di navigazione: comprimi o vai al livello superiore Nel riquadro dell'elenco: passa al riquadro di navigazione
Nel riquadro di navigazione: espandi o passa al riquadro dell'elenco Nel riquadro dell'elenco: passa all'editor
Tab Nel riquadro di navigazione: passare al riquadro dell'elenco Nel riquadro dell'elenco: passare all'editor Nel campo di ricerca: passare al riquadro dell'elenco
Shift+Tab Nel riquadro elenco: passa al riquadro di navigazione Nel campo di ricerca: passa al riquadro di navigazione
Invio (macOS) F2 (Windows/Linux) Rinomina l'elemento direttamente nel riquadro di navigazione o nel riquadro dell'elenco
Invio Nel riquadro di navigazione: apri la nota della cartella su Windows/Linux per impostazione predefinita (se abilitata) Nel riquadro dell'elenco: apri il file selezionato su tutti i sistemi (se abilitato) Nel campo di ricerca: passa al riquadro dell'elenco
Esc Nel campo di ricerca: chiudi la ricerca e sposta il focus sul riquadro dell’elenco
PageUp/PageDown Scorri verso l’alto/verso il basso nel riquadro di navigazione e nel riquadro dell’elenco
Home/Fine Vai al primo/ultimo elemento nel riquadro corrente
Cancella Backspace Elimina elemento selezionato
Cmd/Ctrl+A Seleziona tutte le note nella cartella corrente
Cmd/Ctrl+clic Attiva/disattiva la selezione delle note
Shift+clic Seleziona un intervallo di note
Maiusc+Inizio/Fine Seleziona dalla posizione corrente fino al primo/ultimo elemento
Maiusc+↑/↓ Estendi la selezione verso l'alto/verso il basso
Cmd/Ctrl+↑/↓ Riorganizza i file selezionati verso l'alto/verso il basso in modalità di ordinamento manuale

Nota: Tutti i tasti di scelta rapida possono essere personalizzati. Vedere la sezione 7 - Tasti di scelta rapida personalizzati per i dettagli sull'aggiunta della navigazione in stile VIM (h,j,k,l), dei tasti alternativi e delle combinazioni di modificatori.


5 Impostazioni sincronizzate e locali

Molte impostazioni di Notebook Navigator presentano una levetta di sincronizzazione, un'icona a forma di nuvola che consente di passare da "Attiva sincronizzazione" a "Disattiva sincronizzazione". In questo modo si controlla dove ogni impostazione viene memorizzata e se viene condivisa tra i vari dispositivi.

5.1 Come funziona la sincronizzazione

I plugin di Obsidian memorizzano la loro configurazione in data.json, che si trova in .obsidian/plugins/notebook-navigator/data.json all'interno della cartella del vault. Quando si utilizza un servizio di sincronizzazione, come Obsidian Sync, iCloud, GitHub, Dropbox o Google Drive, questo file viene sincronizzato su tutti i dispositivi insieme al resto del vault. Qualsiasi impostazione salvata in data.json si propagherà a tutti i dispositivi che sincronizzano il vault.

Screenshot 2026-02-18 at 22 58 05

Quando la sincronizzazione è attivata (impostazione predefinita) per un'impostazione, il valore viene salvato in data.json e sincronizzato su tutti i dispositivi tramite il servizio di sincronizzazione.

Screenshot 2026-02-18 at 22 58 14

Quando la sincronizzazione è disattivata per un'impostazione, il valore viene salvato nella memoria locale di Obsidian. La memoria locale è specifica del dispositivo e non è inclusa nella sincronizzazione del vault. L'impostazione avrà il suo valore indipendente su ogni dispositivo. Quando si disabilita la sincronizzazione di un'impostazione, il valore corrente viene copiato nella memoria locale del dispositivo corrente e il valore viene rimosso da data.json per evitare che sovrascriva i valori locali di altri dispositivi.

Se non si utilizza un servizio di sincronizzazione, l'opzione di sincronizzazione non ha alcun effetto pratico, poiché data.json viene memorizzato solo localmente.


6 Ricerca

Notebook Navigator dispone di due modalità di ricerca: ricerca con filtro e ricerca completa. È possibile passare da una modalità all'altra utilizzando i tasti freccia su/giù o facendo clic sull'icona di ricerca. Combinare nomi di file, proprietà, tag, date e filtri in un'unica query (ad esempio, meeting .status=active #work @thisweek).

6.1 Filtro di ricerca

Filtra i file per nome, tag, proprietà, date, cartelle, estensioni e attività all'interno della cartella e delle sottocartelle correnti. Modalità di ricerca predefinita.

Nomi dei file

  • word - Abbinare le note con "word" nel nome del file
  • word1 word2 - Richiedere che ogni parola corrisponda al nome del file
  • -word - Escludere le note con "word" nel nome del file

Tag

  • #tag - Includere le note con il tag (corrisponde anche a tag annidati come #tag/subtag)
  • # - Includere solo note etichettate
  • -#tag - Escludere le note con etichetta
  • -# - Includere solo le note non contrassegnate
  • #tag1 #tag2 - Corrisponde a entrambi i tag (AND implicito)
  • #tag1 AND #tag2 - Corrisponde a entrambi i tag (AND esplicito)
  • #tag1 OR #tag2 - Corrisponde a uno dei due tag
  • #a OR #b AND #c - AND ha una precedenza maggiore: corrisponde a #a, o sia a #b che a #c
  • Cmd/Ctrl+clic su un tag per aggiungere con AND. Cmd/Ctrl+Maiuscolo+Clic per aggiungere con OR

Proprietà

  • .key - Includere le note con la chiave di proprietà
  • .key=value - Includere le note quando il valore della proprietà contiene value
  • ."Reading Status" - Chiave di proprietà con spazi bianchi (doppi apici)
  • ."Reading Status"="In Progress" - Le chiavi e i valori con spazi bianchi devono essere doppi virgolettati
  • -.key - Escludere le note con la chiave di proprietà
  • -.key=value - Escludere le note in cui il valore della proprietà contiene value
  • Cmd/Ctrl+clic su una proprietà per aggiungerla con AND. Cmd/Ctrl+Maiuscolo+Clic per aggiungere con OR

Filtri

  • has:task - Includere note con compiti non completati
  • -has:task - Escludere le note con attività non completate
  • folder:meetings - Includere le note quando il nome di una cartella contiene meetings
  • folder:/work/meetings - Includere le note solo in work/meetings (non nelle sottocartelle)
  • folder:/ - Includere le note solo nella radice del vault
  • -folder:archive - Escludere le note in cui il nome della cartella contiene archive
  • -folder:/archive - Escludere le note solo in archive (non nelle sottocartelle)
  • ext:md - Includere le note con l'estensione md (è supportato ancheext:.md )
  • -ext:pdf - Escludere le note con estensione pdf
  • Combinare con tag, nomi e date (ad esempio, folder:/work/meetings ext:md @thisweek)

Date

  • @today - Abbinare le note di oggi utilizzando il campo data predefinito
  • @yesterday, @last7d, @last30d, @thisweek, @thismonth - Intervalli di date relative
  • @2026-02-07 - Corrispondenza di un singolo giorno (supporta anche @20260207)
  • @2026 - Corrispondenza con un anno solare
  • @2026-02 o @202602 - Corrisponde a un mese di calendario
  • @2026-W05 o @2026W05 - Abbinare una settimana ISO
  • @2026-Q2 o @2026Q2 - Corrisponde a un trimestre di calendario
  • @13/02/2026 - Formati numerici con separatori (@07022026 segue il vostro locale quando è ambiguo)
  • @2026-02-01..2026-02-07 - Corrispondere a una gamma di giorni inclusiva (sono supportati gli estremi aperti)
  • @c:... o @m:... - Data di creazione o modifica del target
  • -@... - Escludere una corrispondenza di data

Il campo data predefinito segue l'ordine corrente. Quando si ordina per nome, il campo data è configurato in Impostazioni → Note → Data → Quando si ordina per nome.

Comportamento AND/OR

AND e OR funzionano in query di soli tag/proprietà (query che contengono solo i filtri #tag, -#tag, #, -#, .key, -.key, .key=value, o -.key=value ). Se la query include anche nomi, date, filtri di attività, filtri di cartella o filtri di estensione, AND e OR vengono abbinati come parole di nome di file.

  • Interrogazione dell'operatore: #work OR .status=started
  • Query mista: #work OR ext:md (OR è abbinato ai nomi dei file)

6.2 Omnisearch

Ricerca full-text nel vault, filtrata alla cartella corrente, alle sottocartelle o ai tag selezionati. Richiede il plugin Omnisearch. Se Omnisearch non è installato, la ricerca torna a essere filtrata.

Le anteprime delle note mostrano estratti dei risultati di Omnisearch invece del testo di anteprima predefinito.

Limiti noti

  • Prestazioni - Può essere lento quando si cercano meno di 3 caratteri in archivi di grandi dimensioni
  • Filtri dei percorsi - L'ambito della cartella viene inviato a Omnisearch solo per i percorsi ASCII semplici. Gli altri percorsi vengono filtrati dopo che Omnisearch ha restituito i risultati
  • Risultati limitati - Omnisearch cerca nell'intero vault e restituisce un numero limitato di risultati prima di filtrare, quindi i file rilevanti della cartella corrente potrebbero non apparire se esistono molte corrispondenze in altre parti
  • Testo di anteprima - Le anteprime delle note sono sostituite da estratti dei risultati di Omnisearch, che potrebbero non mostrare l'effettiva evidenziazione della corrispondenza di ricerca se questa appare in un altro punto del file

7 Tasti di scelta rapida personalizzati

Modificare .obsidian/plugins/notebook-navigator/data.json per personalizzare i tasti di scelta rapida di Notebook Navigator. Aprire il file e individuare la sezione keyboardShortcuts. Ogni voce mappa un'azione a uno o più tasti di scelta rapida:

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

Aggiungere legami multipli per ogni azione per supportare chiavi alternative, come nell'esempio precedente di ArrowUp e K. Combinare i modificatori in una voce elencando ogni valore, ad esempio "modifiers": ["Mod", "Shift"]. Non sono supportate sequenze di tasti come gg o dd. Ricaricare Obsidian dopo aver modificato il file.

7.1 Modificatori

Modificatore Tasto
Mod Cmd (macOS) / Ctrl (Win/Linux)
Alt Alt / Opzione
Shift Maiuscolo
Ctrl Control (preferisce Mod per la multipiattaforma)

7.2 Azioni disponibili

Azione Tasti predefiniti
pane:move-up Freccia su
pane:move-down Freccia giù
pane:page-up Pagina su
pane:page-down Pagina giù
pane:home Home
pane:end Fine
pane:rename Invio (macOS), F2 (Windows/Linux)
pane:delete-selected Canc, Backspace
navigation:collapse-or-parent Freccia sinistra
navigation:expand-or-focus-list Freccia a destra
navigation:focus-list Tab
list:focus-navigation Freccia sinistra, Maiusc+Tab
list:focus-editor Freccia destra, Tab
list:select-all Mod+A
list:extend-selection-up Maiusc+Freccia su
list:extend-selection-down Maiusc+FrecciaGiù
list:manual-sort-up Mod+Freccia su
list:manual-sort-down Mod+Freccia giù
list:range-to-start Maiusc+Home
list:range-to-end Maiusc+Fine
search:focus-list Tab, Invio
search:focus-navigation Maiusc+Tab
search:close Esc

8 Comandi

Impostare tasti di scelta rapida personalizzati per questi comandi nelle impostazioni dei tasti di scelta rapida di Obsidian:

Vista e navigazione

  • Notebook Navigator: Open Apre Notebook Navigator nella barra laterale sinistra. Se è già aperto, sposta il focus della tastiera sul riquadro dell'elenco. Suggerimento: Legare a un tasto di scelta rapida come Cmd/Ctrl+Shift+E per spostare il focus della tastiera sul riquadro dell'elenco: è essenziale per una navigazione completa da tastiera
  • Notebook Navigator: Toggle left sidebar Alterna la barra laterale sinistra. All'apertura, imposta la vista della barra laterale sinistra su Notebook Navigator (a differenza del comando incorporato di Obsidian "Attiva barra laterale sinistra" che ripristina la precedente vista della barra laterale sinistra)
  • Notebook Navigator: Open homepage Apre la vista Notebook Navigator e carica la destinazione della homepage configurata nelle impostazioni
  • Notebook Navigator: Select vault profile Apre la maschera per passare da un profilo all'altro del caveau
  • Notebook Navigator: Reveal file Rivela il file corrente nel navigatore. Espande le cartelle dei genitori e scorre fino al file. Questo comando è utile se l'impostazione Auto-reveal active note è disattivata e si desidera rivelare le note manualmente. Suggerimento: Legare a un tasto di scelta rapida come Cmd/Ctrl+Shift+R per cambiare rapidamente la cartella o l'etichetta selezionata con il file corrente
  • Notebook Navigator: Open all files Apre tutte le note nella cartella o nell'etichetta attualmente selezionata. Quando si aprono 15 o più file, viene visualizzata una finestra di dialogo di conferma
  • Notebook Navigator: Navigate to folder Finestra di ricerca per passare a qualsiasi cartella
  • Notebook Navigator: Navigate to tag Finestra di ricerca per passare a qualsiasi tag
  • Notebook Navigator: Navigate to property Finestra di ricerca per saltare a qualsiasi chiave o valore della proprietà
  • Notebook Navigator: Navigate back Passa alla selezione precedente di cartelle, tag o proprietà nella cronologia del navigatore
  • Notebook Navigator: Navigate forward Passa alla selezione successiva di cartelle, tag o proprietà nella cronologia del navigatore
  • Notebook Navigator: Add to shortcuts Aggiunge o rimuove il file, la cartella, il tag o la proprietà corrente dai collegamenti
  • Notebook Navigator: Open shortcut 1-9 Apre la scorciatoia in base alla sua posizione nell'elenco di scorciatoie
  • Notebook Navigator: Search Apre il campo di ricerca rapida o lo focalizza se è già aperto. La ricerca persiste tra le sessioni. Suggerimento: Legare a un tasto di scelta rapida come Cmd/Ctrl+Shift+S per filtrare rapidamente i file
  • Notebook Navigator: Search whole vault Seleziona la cartella principale dell'archivio e avvia la ricerca includendo le sottocartelle (richiede l'attivazione dell'opzione " Show root folder ")

Selezione

  • Notebook Navigator: Select next file Sposta la selezione al file successivo nella cartella o nella vista tag corrente. Rispetta l'ordine personalizzato. Suggerimento: Legare a un tasto di scelta rapida come Option+Cmd+Right per passare rapidamente al file successivo nell'elenco
  • Notebook Navigator: Select previous file Sposta la selezione al file precedente nella cartella o nella vista tag corrente. Rispetta l'ordine di ordinamento personalizzato. Suggerimento: Legare a un tasto di scelta rapida come Option+Cmd+Left per passare rapidamente al file precedente nell'elenco

Layout e visualizzazione

  • Notebook Navigator: Toggle dual pane layout Alterna il layout a riquadro singolo/doppio (desktop). Suggerimento: Legare a un tasto di scelta rapida come Cmd/Ctrl+Shift+A per passare rapidamente dal layout a riquadro singolo a quello a riquadro doppio
  • Notebook Navigator: Toggle dual pane orientation Alterna l'orientamento del doppio riquadro tra orizzontale e verticale
  • Notebook Navigator: Toggle descendants Alterna la visualizzazione delle sottocartelle/discendenti per cartelle e tag. Suggerimento: Legare a un tasto di scelta rapida come Cmd/Ctrl+Shift+D per attivare rapidamente la visualizzazione delle note dalle sottocartelle/discendenti
  • Notebook Navigator: Toggle hidden folders, tags, and notes Mostra o nascondi cartelle nascoste, tag e note
  • Notebook Navigator: Toggle tag sort order Passa dall'ordinamento alfabetico a quello per frequenza dei tag
  • Notebook Navigator: Toggle tags by selection Alterna la limitazione dei tag a quelli trovati nelle note all'interno della cartella o della proprietà selezionata
  • Notebook Navigator: Toggle properties by selection Alterna la limitazione delle proprietà a quelle presenti nelle note all'interno della cartella o del tag selezionato
  • Notebook Navigator: Toggle compact mode Alterna la modalità elenco tra standard e compatto
  • Notebook Navigator: Toggle pinned section Mostrare o nascondere le note appuntate nel riquadro dell'elenco
  • Notebook Navigator: Collapse / expand all items Collassa o espande tutti gli elementi in base allo stato corrente. Quando Keep selected item expanded è abilitato (per impostazione predefinita è attivo), tutte le cartelle tranne quella corrente saranno collassate. Questo è utile per tenere in ordine l'albero di navigazione durante la ricerca dei documenti
  • Notebook Navigator: Collapse / expand selected item Chiudere o espandere la voce di navigazione selezionata

Calendario

  • Notebook Navigator: Toggle calendar Attiva o disattiva il calendario. Suggerimento: Legare a un tasto di scelta rapida come Cmd/Ctrl+Shift+C per mostrare rapidamente il calendario
  • Notebook Navigator: Open daily note Apre la nota giornaliera di oggi in base alle impostazioni del calendario. Crea la nota se non esiste
  • Notebook Navigator: Open weekly note Apre la nota settimanale corrente. Crea la nota se non esiste
  • Notebook Navigator: Open monthly note Apre la nota mensile corrente. Crea la nota se non esiste
  • Notebook Navigator: Open quarterly note Apre la nota trimestrale corrente. Crea la nota se non esiste
  • Notebook Navigator: Open yearly note Apre la nota annuale corrente. Crea la nota se non esiste

Operazioni sui file

Importante: Obsidian non ha un contesto di "cartella o tag corrente", quindi quando si creano note in Obsidian per default vengono create nella cartella principale, nella stessa cartella del file corrente o in una cartella specifica. Quando si lavora con Notebook Navigator si desidera sempre creare nuove note nella cartella o nell'etichetta attualmente selezionata, quindi la prima cosa da fare è legare Cmd/Ctrl+N a Notebook Navigator: Create new note in modo che le nuove note vengano sempre create nella cartella o nell'etichetta attualmente selezionata. Lo stesso vale anche per lo spostamento e l'eliminazione dei file. Per questo motivo, quando si usa Notebook Navigator, si dovrebbero usare questi comandi invece di quelli integrati di Obsidian.

  • Notebook Navigator: Create new note Crea una nota nella cartella selezionata. Suggerimento: Legare Cmd/Ctrl+N a questo comando (prima staccarlo dal comando predefinito di Obsidian "Crea nuova nota")
  • Notebook Navigator: Create new note from template Crea una nota dal modello nella cartella selezionata (richiede Templater)
  • Notebook Navigator: Move files Sposta i file selezionati in un'altra cartella. Seleziona il file successivo nella cartella corrente
  • Notebook Navigator: Merge notes Crea una nota dalle note Markdown selezionate nell'ordine dell'elenco corrente
  • Notebook Navigator: Convert to folder note Creare una cartella corrispondente al nome del file e spostare il file al suo interno come nota della cartella
  • Notebook Navigator: Set as folder note Rinomina il file attivo con il nome della nota della cartella
  • Notebook Navigator: Detach folder note Staccare la nota di cartella nella cartella selezionata e rinominarla
  • Notebook Navigator: Pin all folder notes Fissa tutte le note delle cartelle in tutte le cartelle. Il comando è visibile solo quando le note delle cartelle sono attivate
  • Notebook Navigator: Delete files Elimina i file selezionati. Seleziona il file successivo nella cartella corrente

Operazioni con tag

  • Notebook Navigator: Add tag to selected files Finestra di dialogo per aggiungere tag ai file selezionati. Supporta la creazione di nuovi tag
  • Notebook Navigator: Set property on selected files Finestra di dialogo per impostare le proprietà sui file selezionati
  • Notebook Navigator: Remove tag from selected files Finestra di dialogo per rimuovere un tag specifico. Rimuove immediatamente se solo un tag
  • Notebook Navigator: Remove all tags from selected files Cancella tutti i tag dai file selezionati con conferma

Manutenzione

  • Notebook Navigator: Rebuild cache Ricostruisce la cache locale di Notebook Navigator. Utilizzare questa funzione se si verificano tag mancanti, anteprime errate o immagini di funzioni mancanti

8.1 ID di comando

ID comando Nome del comando
notebook-navigator:open Navigatore del blocco note: Apri
notebook-navigator:toggle-left-sidebar Navigatore del taccuino: Attiva/disattiva barra laterale sinistra
notebook-navigator:open-homepage Navigatore del notebook: Apri la pagina iniziale
notebook-navigator:select-profile Navigatore del notebook: Seleziona profilo del vault
notebook-navigator:select-profile-1 Navigatore del notebook: Seleziona profilo vault 1
notebook-navigator:select-profile-2 Navigatore del notebook: Seleziona profilo del vault 2
notebook-navigator:select-profile-3 Navigatore del notebook: Seleziona profilo del vault 3
notebook-navigator:reveal-file Navigatore del notebook: Mostra file
notebook-navigator:open-all-files Navigatore del taccuino: Apri tutti i file
notebook-navigator:navigate-to-folder Navigatore del taccuino: Vai alla cartella
notebook-navigator:navigate-to-tag Navigatore del taccuino: Vai al tag
notebook-navigator:navigate-to-property Navigatore del taccuino: Vai alla proprietà
notebook-navigator:navigate-back Navigatore del taccuino: Torna indietro
notebook-navigator:navigate-forward Navigatore del taccuino: vai avanti
notebook-navigator:add-shortcut Navigatore del taccuino: Aggiungi ai collegamenti
notebook-navigator:open-shortcut-1 Navigatore del taccuino: Apri il collegamento 1
notebook-navigator:open-shortcut-2 Navigatore del taccuino: Apri collegamento 2
notebook-navigator:open-shortcut-3 Navigatore del taccuino: Apri collegamento 3
notebook-navigator:open-shortcut-4 Navigatore del taccuino: Apri collegamento 4
notebook-navigator:open-shortcut-5 Navigatore del taccuino: Apri collegamento 5
notebook-navigator:open-shortcut-6 Notebook Navigator: Apri collegamento 6
notebook-navigator:open-shortcut-7 Notebook Navigator: Apri collegamento 7
notebook-navigator:open-shortcut-8 Notebook Navigator: Apri collegamento 8
notebook-navigator:open-shortcut-9 Notebook Navigator: Apri collegamento 9
notebook-navigator:search Notebook Navigator: Cerca
notebook-navigator:search-vault Navigatore del taccuino: Cerca in tutto il vault
notebook-navigator:toggle-dual-pane Navigatore del taccuino: Attiva/disattiva layout a doppio riquadro
notebook-navigator:toggle-dual-pane-orientation Navigatore del taccuino: Attiva/disattiva l'orientamento a doppio riquadro
notebook-navigator:toggle-calendar Navigatore del taccuino: Attiva/disattiva il calendario
notebook-navigator:open-daily-note Navigatore del taccuino: Apri nota giornaliera
notebook-navigator:open-weekly-note Navigatore del taccuino: Apri nota settimanale
notebook-navigator:open-monthly-note Navigatore del taccuino: Apri nota mensile
notebook-navigator:open-quarterly-note Navigatore del taccuino: Apri nota trimestrale
notebook-navigator:open-yearly-note Navigatore del taccuino: Apri nota annuale
notebook-navigator:toggle-descendants Notebook Navigator: Attiva/disattiva i elementi sottostanti
notebook-navigator:toggle-hidden Navigatore del taccuino: Attiva/disattiva cartelle nascoste, tag e note
notebook-navigator:toggle-tag-sort Navigatore del taccuino: Attiva/disattiva l'ordinamento per tag
notebook-navigator:toggle-tags-by-selection Navigatore del taccuino: Attiva/disattiva i tag in base alla selezione
notebook-navigator:toggle-properties-by-selection Navigatore del taccuino: Attiva/disattiva le proprietà in base alla selezione
notebook-navigator:toggle-compact-mode Navigatore del taccuino: Attiva/disattiva la modalità compatta
notebook-navigator:toggle-pinned-section Navigatore del taccuino: Attiva/disattiva la sezione aggiunta
notebook-navigator:collapse-expand Navigatore del taccuino: Comprimi/espandi tutti gli elementi
notebook-navigator:collapse-expand-selected-item Navigatore del taccuino: comprimi/espandi l'elemento selezionato
notebook-navigator:new-note Navigatore del taccuino: Crea nuova nota
notebook-navigator:new-note-from-template Navigatore del taccuino: Crea una nuova nota da un modello
notebook-navigator:move-files Navigatore del taccuino: sposta file
notebook-navigator:merge-notes Navigatore del taccuino: Unisci note
notebook-navigator:select-next-file Navigatore del taccuino: Seleziona il file successivo
notebook-navigator:select-previous-file Navigatore del taccuino: Seleziona file precedente
notebook-navigator:convert-to-folder-note Navigatore del taccuino: Converti in nota cartella
notebook-navigator:set-as-folder-note Navigatore del taccuino: Imposta come nota cartella
notebook-navigator:detach-folder-note Navigatore del taccuino: Stacca nota cartella
notebook-navigator:pin-all-folder-notes Navigatore del taccuino: Aggiungi tutte le note della cartella ai preferiti
notebook-navigator:delete-files Navigatore del taccuino: Elimina file
notebook-navigator:add-tag Navigatore del taccuino: aggiungi un'etichetta ai file selezionati
notebook-navigator:set-property Notebook Navigator: Imposta proprietà sui file selezionati
notebook-navigator:remove-tag Navigatore del taccuino: Rimuovi tag dai file selezionati
notebook-navigator:remove-all-tags Navigatore del taccuino: Rimuovi tutti i tag dai file selezionati
notebook-navigator:rebuild-cache Notebook Navigator: Ricostruire la cache

9 Caratteristiche

9.1 Interfaccia

  • Layout a doppio pannello: riquadro di navigazione (cartelle/tag/proprietà) e riquadro di elenco (file)
  • Modalità a riquadro singolo - Visualizzazioni di navigazione ed elenco con transizioni animate
  • Riquadri ridimensionabili - Orientamento orizzontale o verticale della divisione
  • Zoom indipendente dell'interfaccia utente - Scala il navigatore del notebook senza modificare lo zoom di Obsidian
  • Vista di avvio: prima la navigazione o prima l'elenco
  • Supporto multilingue - 21 lingue con supporto del layout RTL
  • Set di icone dell'interfaccia - Icone personalizzabili dell'interfaccia utente in tutto il plugin

9.2 Navigazione

  • Profili di Vault - Viste multiple filtrate con cartelle/tag/note nascoste per profilo, visibilità dei file, banner e collegamenti
  • Scorciatoie - Note, cartelle, tag, proprietà e ricerche salvate con possibilità di fissare e riordinare
  • Note/file recenti - Sezione degli elementi recenti memorizzata per profilo del vault, con possibilità di appuntare i collegamenti
  • Calendario - Calendario delle note giornaliere con selezione del giorno, anteprime delle immagini e supporto per la suddivisione verticale
  • Albero delle cartelle - Espansione/collasso della navigazione con ordinamento manuale delle cartelle radice
  • Albero dei tag - Tag gerarchici con ordinamento dei tag radice configurabile
  • Browser delle proprietà: consente di sfogliare le proprietà dei file organizzate per chiave e valore, con conteggio dei file, colori personalizzati, icone e trascinamento
  • Rivelazione automatica del file attivo - Espansione della cartella e selezione a scorrimento
  • Tastiera e comandi - Tasti di scelta rapida configurabili, comandi per la cronologia delle selezioni avanti/indietro, comandi per i file successivi/precedenti, comandi per le scorciatoie di apertura 1-9

9.3 Organizzazione

  • Appunti: per mantenere le note importanti in cima alle cartelle e ai tag
  • Note sulla cartella - Impostare/togliere le note sulla cartella, appuntare le note sulla cartella, aprire l'opzione in una nuova scheda
  • Operazioni con i tag: aggiunta/rimozione/cancellazione di tag, rinominazione/cancellazione di tag, creazione di note nei tag, trascinamento della gerarchia dei tag
  • Ordinamento e raggruppamento personalizzati - Sovrascrittura delle impostazioni di ordinamento/gruppo per cartella o tag
  • Aspetti per cartella/tag - Righe di titolo, righe di anteprima, modalità compatta, selezione dei discendenti
  • Contenuti nascosti - Cartelle/tag/nota/file nascosti con modelli, proprietà frontali e filtri basati su tag per profilo di vault
  • Escludi le cartelle dai livelli subordinati - Ometti le cartelle durante la raccolta delle note dalle sottocartelle, in base al profilo dell'archivio; le cartelle escluse rimangono visibili e mostrano le relative note quando vengono selezionate
  • Sistema di colori e icone - Colori di cartelle/tag/proprietà/file, pacchetti di icone, icone emoji/Lucide, lettura/scrittura del frontmatter, mappatura delle icone in base al nome del file e alla categoria del tipo di file
  • Avvertenze sui nomi - Avverte dei caratteri proibiti del filesystem e dei caratteri che interrompono i collegamenti di Obsidian quando si nominano file e cartelle

9.4 Visualizzazione dei file

  • Anteprime delle note - 1-5 righe di anteprima con stripping HTML opzionale
  • Miniature - Immagini in primo piano e miniature generate automaticamente per file PDF, SVG e di disegno memorizzati nella cache dei metadati
  • Immagini esterne - Download facoltativo per immagini esterne e miniature di YouTube
  • Raggruppamento per data - Raggruppa le note per Oggi, Ieri, 7 giorni precedenti, 30 giorni precedenti, mesi e anni quando vengono ordinate per data
  • Supporto frontmatter - Lettura dei nomi delle note e dei timestamp dai campi frontmatter
  • Metadati delle note - Mostra la data di modifica e i tag nell'elenco dei file
  • Proprietà personalizzate: visualizzazione delle proprietà del frontmatter o del conteggio delle parole nell'elenco dei file con sovrascrittura per cartella/tag e colori personalizzati
  • Visualizzazione della cartella madre - Nome e icona della cartella madre opzionale nell'elenco dei file
  • Modalità compatta - Visualizzazione compatta quando l'anteprima, la data e le immagini sono disattivate
  • Tag cliccabili - I tag nell'elenco dei file consentono di navigare direttamente a quel tag

9.5 Produttività

  • Ricerca: filtrare per nome di file, tag, proprietà, date, cartelle, estensioni e attività con AND/OR/esclusioni
  • Integrazione con Omnisearch - Ricerca full-text tramite Omnisearch
  • Trascinamento e rilascio - Spostamento di file, assegnazione di tag, assegnazione di scorciatoie, riperimetrazione dell'albero dei tag, cartelle con caricamento a molla
  • Menu contestuali - Creazione di appunti/cartelle/basi/disegni ed esecuzione di azioni su file/tag
  • Disegni - Creazione di disegni Excalidraw e Tldraw dai menu del pannello di navigazione e dell'elenco
  • Modelli - Nuova nota dai comandi dei modelli con il plugin Templater
  • Operazioni sui file - Creare, rinominare, duplicare, spostare, cestinare file e cartelle
  • Filtraggio - Esclusioni di cartelle/tag/note/file con modelli e proprietà frontmatter

10 Divulgazione della rete e della diagnostica

Notebook Navigator viene eseguito localmente, ma alcune funzioni fanno richieste HTTP da Obsidian. La registrazione di debug all'avvio può anche scrivere un file di diagnostica locale nel caveau.

10.1 Controlli di aggiornamento del rilascio (facoltativo)

  • Impostazione: "Controlla la nuova versione all'avvio"
  • Richiesta: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
  • Frequenza: Al massimo una volta ogni 24 ore, all'avvio
  • Dati: Invia metadati HTTP standard; non include il contenuto del caveau

10.2 Download del pacchetto di icone (opzionale)

  • Impostazione: Abilitare un pacchetto di icone nella scheda Pacchetti di icone
  • Richieste: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (manifest, font, metadati)
  • Memorizzazione: Memorizzato localmente in IndexedDB

10.3 Immagini esterne, video e miniature di YouTube

  • Immagini caratteristiche (opzionale): Controllato dall'impostazione "Scarica immagini esterne". Scarica le immagini remote e le miniature di YouTube per le immagini caratteristiche e le memorizza localmente in IndexedDB.
  • Modale di benvenuto (primo avvio): Carica una miniatura statica da https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
  • Modale "Cosa c'è di nuovo" (all'aggiornamento / all'apertura): Carica le immagini dei banner di rilascio da https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg per le note di rilascio che includono un banner.
  • Finestra modale "Novità" (all'aggiornamento / all'apertura): carica i video relativi alle versioni da https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 per le note di rilascio che includono un video.
  • Finestra modale "Novità" (all'apertura di un video di presentazione): apre i video di presentazione da https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4 in modo che i browser possano riprodurli direttamente.
  • Modale "Cosa c'è di nuovo" (all'aggiornamento / all'apertura): Carica le miniature di YouTube da https://img.youtube.com/vi/<id>/... per le note di rilascio che includono un link a YouTube.

10.4 File di debug all'avvio (opzionale)

  • Impostazione: "Startup debug logging"
  • Memorizzazione: Scrive un file nn-debug-...md con data e ora nella root del vault, quindi si ferma dopo che l'avvio si è stabilizzato. Il file può essere sincronizzato se la root del vault è sincronizzata.
  • Dati: Include i tempi di avvio, la versione del plugin, la versione minima supportata di Obsidian, la piattaforma, il conteggio della cache, il conteggio delle code, lo stato di IndexedDB e gli errori diagnostici. Non include il contenuto delle note, i nomi dei tag, i valori di frontmatter o l'elenco dei file del vault.
  • Percorsi e identificatori: L'inizializzazione dell'avvio, la diagnostica PDF e i casi di errore possono includere l'identificatore dell'app/vault Obsidian, i percorsi PDF relativi al vault o i dettagli dello stack di errori. Rivedere e correggere il file prima di condividerlo pubblicamente.
  • Caricamento: Notebook Navigator non carica i file di debug. Essi vengono condivisi solo se vengono caricati, allegati o sincronizzati al di fuori del plugin.

10.5 Privacy e trattamento dei dati

  • Notebook Navigator non invia il contenuto delle note, i nomi dei file, i tag o i file di debug a un server Notebook Navigator.
  • Le richieste a GitHub, YouTube e a qualsiasi host di immagini esterno vengono effettuate direttamente dal dispositivo dell'utente e includono metadati HTTP standard (indirizzo IP, user-agent e simili).
  • I pacchetti di icone e le immagini scaricate sono memorizzati localmente (IndexedDB). Le note/file recenti e lo stato dell'interfaccia utente sono memorizzati localmente (Obsidian local storage).

11 Stelle Storia

Star History Chart


12 Contatto

Notebook Navigator è costruito e gestito da Johan Sanneblad. Johan ha conseguito un dottorato di ricerca in sviluppo software e ha lavorato allo sviluppo di innovazioni per aziende come Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group e Yamaha.

Sentitevi liberi di connettervi con me su LinkedIn.


13 Domande o problemi?

Unitevi al nostro Discord per supporto e discussioni, oppure aprite un problema sulrepository GitHub.

Non si accettano pull request. Con l'avvento della programmazione agentica, non è possibile garantire che il codice inviato dall'esterno rispetti gli standard di qualità del progetto; pertanto, qualsiasi pull request viene chiusa automaticamente. Contribuisci invece con le tue idee sotto forma di richieste di funzionalità: apri un issue. Per ulteriori dettagli , consulta il file CONTRIBUTING.md.


14 Licenza

Questo progetto è rilasciato sotto licenza GNU General Public License v3.0 - si veda il file LICENSE per i dettagli.