Indice della documentazione

Documentazione principale

Documentazione per 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 in base a nome visualizzato, alias, tag, proprietà, date, cartelle, estensioni e attività all'interno della cartella corrente e delle sottocartelle. Modalità di ricerca predefinita.

Nomi dei file e alias

  • word - Trova le note che contengono la parola "word" nel nome visualizzato o in un alias
  • word1 word2 - Richiedere che ogni parola corrisponda sia nel nome visualizzato che negli alias
  • -word - Escludere le note che contengono la parola "word" nel nome visualizzato o in un alias
  • ".F" - Corrispondenza letterale del testo; un termine che inizia con una virgoletta doppia non viene mai interpretato come un tag, una proprietà, una data o un filtro (ad esempio, ` ".F" ` individua i nomi contenenti ` .F `, anziché applicare un filtro su una proprietà)
  • -".F" - Escludere le note che contengono il testo esatto nel nome visualizzato o in un alias

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 note con una chiave di proprietà che inizi con key
  • .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 - Escludi le note con una chiave di proprietà che inizia con key
  • -.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 per percorso - L'ambito delle cartelle viene inviato a Omnisearch per tutti i percorsi delle cartelle, ad eccezione dei nomi contenenti " o ,. I nomi delle cartelle con caratteri non ASCII richiedono Omnisearch 1.30.0 o versioni successive. I risultati vengono sempre filtrati in base alla vista corrente dopo che Omnisearch ha restituito i risultati
  • Risultati limitati - Omnisearch restituisce al massimo 50 risultati. Quando si effettua una ricerca in una cartella, il limite si applica alla cartella e alle sue sottocartelle, pertanto i risultati trovati nelle sottocartelle vengono conteggiati ai fini del limite anche quando l'opzione " Show notes from subfolders " è disattivata
  • 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: Select vault profile 1-3 Attiva un profilo del caveau in base alla sua posizione. Se in quella posizione non esiste alcun profilo, apre la finestra modale di selezione del profilo
  • 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 (opzione disponibile quando è abilitata l'opzione " Show root folder " o " Show hidden items ")

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 Attiva/disattiva la visualizzazione a pannello singolo o doppio (desktop e tablet). Suggerimento: associa una scorciatoia da tastiera, ad esempio Cmd/Ctrl+Shift+A, per passare rapidamente dalla visualizzazione a pannello singolo a quella a doppio pannello
  • 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 navigation items Comprimi o espandi tutte le voci di navigazione in base allo stato corrente. Quando è attivata l'opzione " Keep selected item expanded " (impostazione predefinita: attiva), tutte le cartelle tranne quella corrente verranno compresse. Questa funzione è utile per mantenere ordinata la struttura 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
  • Notebook Navigator: Restore default settings Sostituisce il file delle impostazioni con i valori predefiniti verificati dopo aver salvato un backup con indicazione della data e dell'ora. Questo comando è disponibile solo quando Notebook Navigator non riesce a leggere le proprie impostazioni e si blocca durante l'avvio

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 notebook: 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 Notebook Navigator: Mostra file
notebook-navigator:open-all-files Navigatore del notebook: 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 Notebook Navigator: 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 Notebook Navigator: Cerca in tutto il vault
notebook-navigator:toggle-dual-pane Navigatore del taccuino: Attiva/disattiva il 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 sottocartelle
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-list-groups Navigatore del taccuino: Comprimi/espandi tutti i gruppi dell'elenco
notebook-navigator:collapse-expand Navigatore del taccuino: comprimi/espandi tutte le voci di navigazione
notebook-navigator:collapse-expand-selected-item Navigatore del taccuino: comprimi/espandi la voce selezionata
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 i file
notebook-navigator:merge-notes Navigatore del taccuino: Unisci note
notebook-navigator:select-next-file Navigatore del taccuino: Seleziona 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 Notebook Navigator: Aggiungi tag ai file selezionati
notebook-navigator:set-property Navigatore del taccuino: 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 Navigatore del taccuino: Ricostruisci la cache
notebook-navigator:restore-default-settings Notebook Navigator: Ripristina impostazioni predefinite

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 iniziale a pannello singolo - Pannello di navigazione o pannello 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
  • Raggruppamento in base alle proprietà - Raggruppa le note in base al valore di una proprietà del frontmatter, con un criterio di raggruppamento analogo a quello di Obsidian Bases: le note che condividono lo stesso valore vengono raccolte sotto un'unica intestazione, quelle prive di tale proprietà vengono inserite in un gruppo finale denominato "None", e i gruppi vengono ordinati in base al valore con ordinamento naturale
  • 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
  • Stato delle attività - Mostra lo stato di avanzamento delle attività nelle righe standard e, se lo si desidera, sostituisci le icone dei file relative alle attività non completate nelle modalità di visualizzazione "compatta" o "tutte"
  • 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 principale - Nome e icona della cartella principale (facoltativi) 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 - Filtra per nome file, alias, tag, proprietà, date, cartelle, estensioni e attività con operatori 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.
  • Finestra modale di benvenuto (primo avvio): carica una miniatura di YouTube da https://img.youtube.com/vi/<id>/....
  • Finestra modale "Novità" (all'aggiornamento / all'apertura): carica le immagini del banner delle versioni da https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<filename> utilizzando il nome file e l'estensione indicati nelle note di rilascio.
  • 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 Contatti

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.


12 Domande o dubbi?

Leggi le FAQ per trovare le risposte alle domande più frequenti.

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.


13 Licenza

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