Index de la documentation

Documentation principale

Documentation pour les développeurs

  • Référence API - Documentation de l'API publique. Couvre la gestion des métadonnées, le contrôle de la navigation et les abonnements aux événements pour les développeurs JavaScript/TypeScript.
  • Guide des thèmes - Guide pour les développeurs de thèmes. Il comprend une référence aux classes CSS, des propriétés personnalisées et des exemples de thèmes pour les modes clair et foncé.
  • Processus de démarrage - Séquence d'initialisation du plugin. Flux de démarrage à froid ou à chaud, résolution du cache de métadonnées, nettoyage différé et pipeline de génération de contenu. Inclut les diagrammes Mermaid.
  • Pipeline de métadonnées - Séquence de reconstruction du cache, étapes du pipeline du fournisseur et signaux d'achèvement. Inclut les diagrammes Mermaid.
  • Architecture du stockage - Guide des conteneurs de stockage (IndexedDB, Local Storage, Memory Cache, Settings). Modèles de flux de données et directives d'utilisation.
  • Architecture de rendu - Hiérarchie des composants React, défilement virtuel avec TanStack Virtual, optimisation des performances et flux de données.
  • Orchestration du défilement - Comment le plugin assure un défilement précis lorsque les structures de l'arbre changent (visibilité des balises, paramètres, etc.)
  • Architecture des services - Couche de logique commerciale : MetadataService, FileSystemOperations, ContentProviderRegistry. Modèles d'injection de dépendance et flux de données des services.

1 Installation

  1. Installer Obsidian - Télécharger et installer à partir de obsidian.md
  2. Activerles plugins communautaires - Aller dans Paramètres → Plugins communautaires → Activer les plugins communautaires
  3. Installer Notebook Navigator - Cliquer sur "Parcourir" → Rechercher "Notebook Navigator" → Installer
  4. Installer Style Settings (optionnel ) - Pour personnaliser les couleurs et l'apparence, installez le plugin Style Settings en recherchant "Style Settings" dans Community plugins

2 Mise en route

Voici le tutoriel officiel pour apprendre et maîtriser Notebook Navigator :

Mastering Notebook Navigator

La vidéo est sous-titrée en 21 langues.


3 Sécurité et qualité

Notebook Navigator est vérifié avec TypeScript, ESLint avec le plugin officiel Obsidian ESLint, Prettier, Vitest et une version de production avant que les changements ne soient fusionnés. La compilation doit se terminer avec zéro erreur et zéro avertissement.

Les contrôles de sécurité sont exécutés via CodeQL, avec l'historique des analyses dans le flux de travail CodeQL et la carte de score OpenSSF. L'état actuel est indiqué dans les badges en haut de cette page.

Le Notebook Navigator fonctionne localement, mais certaines fonctions font des requêtes HTTP documentées pour les mises à jour, les téléchargements et le contenu distant. Voir la section 10 - Divulgation des réseaux et des diagnostics pour la liste complète.


Table des matières


4 Raccourcis clavier

Clé Action
↑/↓ Se déplacer vers le haut/vers le bas dans le volet actuel
Dans le volet de navigation : réduire ou accéder à l' parent Dans le volet de liste : basculer vers le volet de navigation
Dans le volet de navigation : développer ou basculer vers le volet de liste Dans le volet de liste : basculer vers l'éditeur
Tab Dans le volet de navigation : basculer vers le volet de liste Dans le volet de liste : basculer vers l'éditeur Dans le champ de recherche : basculer vers le volet de liste
Maj+Tab Dans le volet de liste : basculer vers le volet de navigation Dans le champ de recherche : basculer vers le volet de navigation
Entrée (macOS) F2 (Windows/Linux) Renommer un élément directement dans le volet de navigation ou le volet de liste
Entrée Dans le volet de navigation : ouvrir la note du dossier sous Windows/Linux par défaut (lorsque cette option est activée) Dans le volet de liste : ouvrir le fichier sélectionné sur tous les systèmes (lorsque cette option est activée) Dans le champ de recherche : basculer vers le volet de liste
Échap Dans le champ de recherche : fermer la recherche et placer le focus sur le volet de liste
Page précédente/Page suivante Faire défiler vers le haut/vers le bas dans le volet de navigation et le volet de liste
Début/Fin Aller au premier/dernier élément du volet actuel
Supprimer l' Retour arrière Supprimer l'élément sélectionné
Cmd/Ctrl+A Sélectionner toutes les notes du dossier actuel
Cmd/Ctrl+clic Activer/désactiver la sélection des notes
Maj+clic Sélectionner une plage de notes
Maj + Début/Fin Sélectionner de la position actuelle jusqu'au premier/dernier élément
Maj + ↑/↓ Étendre la sélection vers le haut/vers le bas
Cmd/Ctrl+↑/↓ Réorganiser les fichiers sélectionnés vers le haut ou vers le bas en mode de tri manuel

Remarque : tous les raccourcis clavier peuvent être personnalisés. Voir la section 7 - Raccourcis personnalisés pour plus de détails sur l'ajout de touches de navigation de type VIM (h,j,k,l), de touches alternatives et de combinaisons de modificateurs.


5 Paramètres synchronisés et locaux

De nombreux paramètres du Notebook Navigator affichent une bascule de synchronisation - une icône de nuage qui permet de basculer entre "Activer la synchronisation" et "Désactiver la synchronisation". Cela permet de contrôler l'endroit où chaque paramètre est stocké et s'il est partagé entre les appareils.

5.1 Comment fonctionne la synchronisation

Les plugins Obsidian stockent leur configuration dans le fichier data.json, situé à l'adresse .obsidian/plugins/notebook-navigator/data.json dans votre dossier de coffre-fort. Lorsque vous utilisez un service de synchronisation - comme Obsidian Sync, iCloud, GitHub, Dropbox ou Google Drive - ce fichier est synchronisé sur tous vos appareils avec le reste de votre coffre-fort. Tout paramètre enregistré sur data.json se propage à tous les appareils qui synchronisent le coffre-fort.

Screenshot 2026-02-18 at 22 58 05

Lorsque la synchronisation est activée (par défaut) pour un paramètre, la valeur est enregistrée sur data.json et synchronisée avec tous les appareils via votre service de synchronisation.

Screenshot 2026-02-18 at 22 58 14

Lorsque la synchronisation est désactivée pour un paramètre, la valeur est enregistrée dans le stockage local d'Obsidian. Le stockage local est spécifique à chaque appareil et n'est pas inclus dans la synchronisation de l'espace de stockage. Le paramètre aura sa propre valeur indépendante sur chaque appareil. Lorsque vous désactivez la synchronisation pour un paramètre, la valeur actuelle est copiée dans le stockage local sur le périphérique actuel et la valeur est supprimée de data.json pour éviter qu'elle n'écrase les valeurs locales sur d'autres périphériques.

Si vous n'utilisez pas de service de synchronisation, l'option de synchronisation n'a aucun effet pratique puisque data.json n'est stocké que localement.


6 Recherche

Le Notebook Navigator dispose de deux modes de recherche : la recherche par filtre et la recherche globale. Vous pouvez passer de l'un à l'autre à l'aide des touches fléchées haut/bas ou en cliquant sur l'icône de recherche. Combinez les noms de fichiers, les propriétés, les étiquettes, les dates et les filtres en une seule requête (par exemple, meeting .status=active #work @thisweek).

6.1 Filtrer la recherche

Filtre les fichiers par nom, étiquettes, propriétés, dates, dossiers, extensions et tâches dans le dossier et les sous-dossiers actuels. Mode de recherche par défaut.

Noms de fichiers

  • word - Correspondre aux notes dont le nom de fichier contient "word"
  • word1 word2 - Exiger que chaque mot corresponde au nom du fichier
  • -word - Exclure les notes contenant "word" dans le nom du fichier

Tags

  • #tag - Inclure les notes avec la balise (correspond également aux balises imbriquées comme #tag/subtag)
  • # - Inclure uniquement les notes étiquetées
  • -#tag - Exclure les notes avec étiquette
  • -# - Inclure uniquement les notes non marquées
  • #tag1 #tag2 - Faire correspondre les deux balises (AND implicite)
  • #tag1 AND #tag2 - Faire correspondre les deux balises (ET explicite)
  • #tag1 OR #tag2 - Correspondre à l'une ou l'autre des étiquettes
  • #a OR #b AND #c - AND a une priorité plus élevée : correspond à #a, ou à la fois à #b et à #c
  • Cmd/Ctrl+Clic sur une balise pour l'ajouter avec ET. Cmd/Ctrl+Shift+Click pour ajouter avec OR

Propriétés

  • .key - Inclure des notes avec la clé de propriété
  • .key=value - Inclure des notes lorsque la valeur du bien contient value
  • ."Reading Status" - Clé de propriété avec espacement (guillemets doubles)
  • ."Reading Status"="In Progress" - Les clés et les valeurs comportant des espaces doivent être mises entre guillemets
  • -.key - Exclure les notes avec la clé de propriété
  • -.key=value - Exclure les notes dont la valeur contient value
  • Cmd/Ctrl+Clic sur une propriété pour l'ajouter avec AND. Cmd/Ctrl+Shift+Click pour ajouter avec OR

Filtres

  • has:task - Inclure des notes sur les tâches inachevées
  • -has:task - Exclure les notes contenant des tâches inachevées
  • folder:meetings - Inclure des notes lorsque le nom d'un dossier contient meetings
  • folder:/work/meetings - Inclure des notes uniquement dans work/meetings (pas dans les sous-dossiers)
  • folder:/ - Inclure les notes uniquement dans la racine du coffre-fort
  • -folder:archive - Exclure les notes dont le nom de dossier contient archive
  • -folder:/archive - Exclure les notes uniquement dans archive (pas dans les sous-dossiers)
  • ext:md - Inclure des notes avec l'extension md (ext:.md est également pris en charge)
  • -ext:pdf - Exclure les notes avec extension pdf
  • Combiner avec des étiquettes, des noms et des dates (par exemple, folder:/work/meetings ext:md @thisweek)

Dates

  • @today - Faire correspondre les notes d'aujourd'hui à l'aide du champ de date par défaut
  • @yesterday, @last7d, @last30d, @thisweek, @thismonth - Plages de dates relatives
  • @2026-02-07 - Correspondre à un seul jour (supporte également @20260207)
  • @2026 - Correspondre à une année civile
  • @2026-02 ou @202602 - Correspond à un mois civil
  • @2026-W05 ou @2026W05 - Correspondre à une semaine ISO
  • @2026-Q2 ou @2026Q2 - Correspond à un trimestre civil
  • @13/02/2026 - Formats numériques avec séparateurs (@07022026 suit votre locale en cas d'ambiguïté)
  • @2026-02-01..2026-02-07 - Correspondre à un éventail de jours inclusifs (les extrémités ouvertes sont prises en charge)
  • @c:... ou @m:... - Date de création ou de modification de la cible
  • -@... - Exclure une correspondance de date

Le champ date par défaut suit l'ordre de tri actuel. Lors d'un tri par nom, le champ date est configuré dans Paramètres → Notes → Date → Lors d'un tri par nom.

ET/OU comportement

AND et OR fonctionnent dans les requêtes de balises/propriétés uniquement (requêtes qui contiennent uniquement les filtres #tag, -#tag, #, -#, .key, -.key, .key=value, ou -.key=value ). Si la requête comprend également des noms, des dates, des filtres de tâches, des filtres de dossiers ou des filtres d'extensions, AND et OR sont recherchés en tant que mots de noms de fichiers.

  • Requête de l'opérateur : #work OR .status=started
  • Requête mixte : #work OR ext:md (OR est recherché dans les noms de fichiers)

6.2 Omnisearch

Recherche en texte intégral dans le coffre-fort, filtrée sur le dossier en cours, les sous-dossiers ou les balises sélectionnées. Nécessite le plugin Omnisearch. Si Omnisearch n'est pas installé, la recherche revient à la recherche par filtre.

Les aperçus de notes affichent des extraits de résultats d'Omnisearch au lieu du texte d'aperçu par défaut.

Limites connues

  • Performances - Peut être lent lors de la recherche de moins de 3 caractères dans les grands coffres-forts
  • Filtres de chemin d'accès - La portée du dossier n'est transmise à Omnisearch que pour les chemins d'accès ASCII simples. Les autres chemins d'accès sont filtrés une fois qu'Omnisearch a renvoyé ses résultats
  • Résultats limités - Omnisearch recherche dans l'ensemble du coffre-fort et renvoie un nombre limité de résultats avant le filtrage, de sorte que les fichiers pertinents du dossier actuel peuvent ne pas apparaître si de nombreuses correspondances existent ailleurs
  • Texte de prévisualisation - Les prévisualisations des notes sont remplacées par des extraits des résultats d'Omnisearch, qui peuvent ne pas afficher le surlignage de la correspondance de recherche s'il apparaît ailleurs dans le fichier

7 Touches de raccourci personnalisées

Modifiez .obsidian/plugins/notebook-navigator/data.json pour personnaliser les touches de raccourci du navigateur de l'ordinateur portable. Ouvrez le fichier et localisez la section keyboardShortcuts. Chaque entrée associe une action à une ou plusieurs combinaisons de touches :

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

Ajoutez plusieurs liaisons par action pour prendre en charge des clés alternatives, comme dans l'exemple ArrowUp et K ci-dessus. Combinez les modificateurs dans une entrée en énumérant chaque valeur, par exemple "modifiers": ["Mod", "Shift"]. Les séquences de clavier telles que gg ou dd ne sont pas prises en charge. Rechargez Obsidian après avoir modifié le fichier.

7.1 Modificateurs

Modificateur Clé
Mod Cmd (macOS) / Ctrl (Win/Linux)
Alt Alt / Option
Shift Majuscule
Ctrl Contrôle (préférer Mod pour une utilisation multiplateforme)

7.2 Actions disponibles

Action Touche(s) par défaut
pane:move-up Flèche vers le haut
pane:move-down Flèche vers le bas
pane:page-up Page précédente
pane:page-down Page suivante
pane:home Accueil
pane:end Fin
pane:rename Entrée (macOS), F2 (Windows/Linux)
pane:delete-selected Suppr, Retour arrière
navigation:collapse-or-parent Flèche gauche
navigation:expand-or-focus-list Flèche droite
navigation:focus-list Tab
list:focus-navigation Flèche gauche, Maj+Tab
list:focus-editor Flèche droite, Tab
list:select-all Mod+A
list:extend-selection-up Maj + Flèche vers le haut
list:extend-selection-down Maj + Flèche vers le bas
list:manual-sort-up Mod+Flèche vers le haut
list:manual-sort-down Mod+Flèche vers le bas
list:range-to-start Maj+Début
list:range-to-end Maj+Fin
search:focus-list Tab, Entrée
search:focus-navigation Maj+Tab
search:close Échap

8 Commandes

Définissez des raccourcis personnalisés pour ces commandes dans les paramètres de raccourcis d'Obsidian :

Vue et navigation

  • Notebook Navigator: Open Ouvre le navigateur de l'ordinateur portable dans la barre latérale gauche. S'il est déjà ouvert, il déplace le curseur du clavier vers le volet de liste. Suggestion : Lier à une touche de raccourci comme Cmd/Ctrl+Shift+E pour déplacer le focus du clavier vers le volet de liste - ceci est essentiel pour une navigation complète au clavier
  • Notebook Navigator: Toggle left sidebar Bascule la barre latérale gauche. À l'ouverture, l'affichage de la barre latérale gauche est celui du Navigateur de carnet (contrairement à la commande intégrée "Toggle left sidebar" d'Obsidian qui rétablit l'affichage précédent de la barre latérale gauche)
  • Notebook Navigator: Open homepage Ouvre la vue Navigateur du carnet de notes et charge la cible de la page d'accueil configurée dans les paramètres
  • Notebook Navigator: Select vault profile Ouvre une fenêtre modale pour passer d'un profil de chambre forte à l'autre
  • Notebook Navigator: Reveal file Affiche le fichier actuel dans le navigateur. Développe les dossiers parents et fait défiler jusqu'au fichier. Cette commande est utile si vous avez désactivé le paramètre Auto-reveal active note et que vous souhaitez révéler les notes manuellement. Suggestion : Lier à une touche de raccourci comme Cmd/Ctrl+Shift+R pour changer rapidement le dossier ou l'étiquette sélectionné(e) en fichier courant
  • Notebook Navigator: Open all files Ouvre toutes les notes du dossier ou de l'étiquette sélectionné(e). Lors de l'ouverture de 15 fichiers ou plus, une boîte de dialogue de confirmation s'affiche
  • Notebook Navigator: Navigate to folder Dialogue de recherche pour accéder à n'importe quel dossier
  • Notebook Navigator: Navigate to tag Dialogue de recherche pour accéder à n'importe quelle balise
  • Notebook Navigator: Navigate to property Dialogue de recherche pour accéder à n'importe quelle clé ou valeur de propriété
  • Notebook Navigator: Navigate back Permet de revenir à la sélection précédente de dossier, d'étiquette ou de propriété dans l'historique du navigateur
  • Notebook Navigator: Navigate forward Permet de passer au dossier, à l'étiquette ou à la propriété suivante dans l'historique du navigateur
  • Notebook Navigator: Add to shortcuts Ajoute ou supprime le fichier, le dossier, l'étiquette ou la propriété en cours des raccourcis
  • Notebook Navigator: Open shortcut 1-9 Ouvre le raccourci en fonction de sa position dans la liste des raccourcis
  • Notebook Navigator: Search Ouvre le champ de recherche rapide ou le concentre s'il est déjà ouvert. La recherche persiste entre les sessions. Suggestion : Lier à une touche de raccourci comme Cmd/Ctrl+Shift+S pour un filtrage rapide des fichiers
  • Notebook Navigator: Search whole vault Sélectionne le dossier racine du coffre-fort et lance une recherche incluant les sous-dossiers (nécessite l'activation de la fonction « Show root folder »)

La sélection

  • Notebook Navigator: Select next file Déplace la sélection vers le fichier suivant dans la vue du dossier ou de l'étiquette en cours. Respecte l'ordre de tri personnalisé. Suggestion : Lier à une touche de raccourci comme Option+Cmd+Right pour passer rapidement au fichier suivant dans la liste
  • Notebook Navigator: Select previous file Déplace la sélection vers le fichier précédent dans la vue du dossier ou de l'étiquette en cours. Respecte l'ordre de tri personnalisé. Suggestion : Lier à une touche de raccourci comme Option+Cmd+Left pour aller rapidement au fichier précédent dans la liste

Mise en page et affichage

  • Notebook Navigator: Toggle dual pane layout Basculer la mise en page en un ou deux volets (bureau). Suggestion : Lier à une touche de raccourci comme Cmd/Ctrl+Shift+A pour basculer rapidement entre la disposition à un ou deux volets
  • Notebook Navigator: Toggle dual pane orientation Basculer l'orientation du double volet entre l'horizontale et la verticale
  • Notebook Navigator: Toggle descendants Afficher les notes des sous-dossiers / descendants pour les dossiers et les étiquettes. Suggestion : Lier à une touche de raccourci comme Cmd/Ctrl+Shift+D pour basculer rapidement l'affichage des notes des sous-dossiers / descendants
  • Notebook Navigator: Toggle hidden folders, tags, and notes Afficher ou masquer les dossiers, les balises et les notes cachés
  • Notebook Navigator: Toggle tag sort order Basculer entre le tri alphabétique et le tri par fréquence des balises
  • Notebook Navigator: Toggle tags by selection Limiter les balises à celles qui se trouvent dans les notes du dossier ou de la propriété sélectionné(e)
  • Notebook Navigator: Toggle properties by selection Basculer de la limitation des propriétés à celles trouvées dans les notes du dossier ou de l'étiquette sélectionné(e)
  • Notebook Navigator: Toggle compact mode Basculer entre le mode liste standard et le mode liste compacte
  • Notebook Navigator: Toggle pinned section Afficher ou masquer les notes épinglées dans le volet de liste
  • Notebook Navigator: Collapse / expand all items Réduire ou développer tous les éléments en fonction de l'état actuel. Lorsque l'option Keep selected item expanded est activée (activée par défaut), tous les dossiers, à l'exception du dossier en cours, sont réduits. Cette fonction est pratique pour garder l'arbre de navigation ordonné lors de la recherche de documents
  • Notebook Navigator: Collapse / expand selected item Réduire ou développer l'élément de navigation sélectionné

Calendrier

  • Notebook Navigator: Toggle calendar Permet d'activer ou de désactiver le calendrier. Suggestion : Lier à une touche de raccourci comme Cmd/Ctrl+Shift+C pour afficher rapidement le calendrier
  • Notebook Navigator: Open daily note Ouvre la note quotidienne du jour en fonction des paramètres du calendrier. Crée la note si elle n'existe pas
  • Notebook Navigator: Open weekly note Ouvre la note hebdomadaire en cours. Crée la note si elle n'existe pas
  • Notebook Navigator: Open monthly note Ouvre la note mensuelle en cours. Crée la note si elle n'existe pas
  • Notebook Navigator: Open quarterly note Ouvre la note trimestrielle en cours. Crée la note si elle n'existe pas
  • Notebook Navigator: Open yearly note Ouvre la note annuelle en cours. Crée la note si elle n'existe pas

Opérations sur les fichiers

Important : Obsidian n'a pas de contexte de "dossier ou d'étiquette en cours". Par conséquent, lorsque vous créez des notes dans Obsidian, elles sont créées par défaut dans le dossier racine, dans le même dossier que le fichier en cours ou dans un dossier spécifique. Lorsque vous travaillez avec Notebook Navigator, vous souhaitez toujours créer de nouvelles notes dans le dossier ou l'étiquette sélectionné(e). La première chose à faire est donc de lier Cmd/Ctrl+N à Notebook Navigator: Create new note afin que les nouvelles notes soient toujours créées dans le dossier ou l'étiquette sélectionné(e). Il en va de même pour le déplacement et la suppression de fichiers. C'est pourquoi vous devez utiliser ces commandes plutôt que les commandes intégrées d'Obsidian lorsque vous utilisez le Navigateur de carnet.

  • Notebook Navigator: Create new note Créer une note dans le dossier sélectionné. Suggestion : Lier Cmd/Ctrl+N à cette commande (en commençant par se détacher de la commande par défaut d'Obsidian "Créer une nouvelle note")
  • Notebook Navigator: Create new note from template Créer une note à partir d'un modèle dans le dossier sélectionné (nécessite Templater)
  • Notebook Navigator: Move files Déplace les fichiers sélectionnés vers un autre dossier. Sélectionne le fichier suivant dans le dossier actuel
  • Notebook Navigator: Merge notes Créer une note à partir des notes Markdown sélectionnées dans l'ordre de la liste actuelle
  • Notebook Navigator: Convert to folder note Créez un dossier correspondant au nom du fichier et déplacez le fichier à l'intérieur en tant que note de dossier
  • Notebook Navigator: Set as folder note Renommer le fichier actif avec le nom de sa note de dossier
  • Notebook Navigator: Detach folder note Détacher la note de dossier dans le dossier sélectionné et la renommer
  • Notebook Navigator: Pin all folder notes Épingler toutes les notes de dossier dans tous les dossiers. Cette commande n'est visible que lorsque les notes de dossier sont activées.
  • Notebook Navigator: Delete files Supprime les fichiers sélectionnés. Sélectionne le fichier suivant dans le dossier actuel

Opérations de marquage

  • Notebook Navigator: Add tag to selected files Boîte de dialogue pour ajouter une balise aux fichiers sélectionnés. Prise en charge de la création de nouvelles étiquettes
  • Notebook Navigator: Set property on selected files Boîte de dialogue pour définir les propriétés des fichiers sélectionnés
  • Notebook Navigator: Remove tag from selected files Boîte de dialogue permettant de supprimer une balise spécifique. Supprime immédiatement si une seule balise
  • Notebook Navigator: Remove all tags from selected files Effacer toutes les étiquettes des fichiers sélectionnés avec confirmation

Maintenance

  • Notebook Navigator: Rebuild cache Reconstitue le cache local du Notebook Navigator. Utilisez cette fonction si vous constatez qu'il manque des balises, des aperçus incorrects ou des images de caractéristiques manquantes

8.1 ID de commande

ID de commande Nom de la commande
notebook-navigator:open Navigateur de bloc-notes : Ouvrir
notebook-navigator:toggle-left-sidebar Navigateur de bloc-notes : Afficher/masquer la barre latérale gauche
notebook-navigator:open-homepage Navigateur de bloc-notes : Ouvrir la page d'accueil
notebook-navigator:select-profile Navigateur du bloc-notes : Sélectionner un profil de coffre-fort
notebook-navigator:select-profile-1 Navigateur du bloc-notes : Sélectionner le profil de coffre-fort 1
notebook-navigator:select-profile-2 Navigateur du bloc-notes : sélectionner le profil de coffre-fort 2
notebook-navigator:select-profile-3 Navigateur de bloc-notes : sélectionner le profil de coffre-fort 3
notebook-navigator:reveal-file Navigateur de bloc-notes : Afficher le fichier
notebook-navigator:open-all-files Navigateur de bloc-notes : Ouvrir tous les fichiers
notebook-navigator:navigate-to-folder Navigateur de bloc-notes : Accéder au dossier
notebook-navigator:navigate-to-tag Navigateur de bloc-notes : Accéder à une balise
notebook-navigator:navigate-to-property Navigateur de bloc-notes : Accéder à une propriété
notebook-navigator:navigate-back Navigateur de bloc-notes : Retour
notebook-navigator:navigate-forward Navigateur de bloc-notes : aller de l'avant
notebook-navigator:add-shortcut Navigateur de bloc-notes : Ajouter aux raccourcis
notebook-navigator:open-shortcut-1 Navigateur de bloc-notes : Ouvrir le raccourci 1
notebook-navigator:open-shortcut-2 Navigateur de bloc-notes : Ouvrir le raccourci 2
notebook-navigator:open-shortcut-3 Navigateur de bloc-notes : Ouvrir le raccourci 3
notebook-navigator:open-shortcut-4 Navigateur de bloc-notes : Ouvrir le raccourci 4
notebook-navigator:open-shortcut-5 Navigateur de bloc-notes : Ouvrir le raccourci 5
notebook-navigator:open-shortcut-6 Navigateur de bloc-notes : Ouvrir le raccourci 6
notebook-navigator:open-shortcut-7 Navigateur de bloc-notes : Ouvrir le raccourci 7
notebook-navigator:open-shortcut-8 Navigateur de bloc-notes : Ouvrir le raccourci 8
notebook-navigator:open-shortcut-9 Navigateur de bloc-notes : Ouvrir le raccourci 9
notebook-navigator:search Navigateur de bloc-notes : Rechercher
notebook-navigator:search-vault Navigateur de bloc-notes : Rechercher dans l'ensemble du coffre-fort
notebook-navigator:toggle-dual-pane Navigateur de bloc-notes : basculer entre les deux volets
notebook-navigator:toggle-dual-pane-orientation Navigateur de bloc-notes : basculer l'orientation du double volet
notebook-navigator:toggle-calendar Navigateur de carnets : Activer/désactiver le calendrier
notebook-navigator:open-daily-note Navigateur de carnets : Ouvrir une note quotidienne
notebook-navigator:open-weekly-note Navigateur de carnets : Ouvrir la note hebdomadaire
notebook-navigator:open-monthly-note Navigateur du carnet : Ouvrir la note mensuelle
notebook-navigator:open-quarterly-note Navigateur du carnet : Ouvrir une note trimestrielle
notebook-navigator:open-yearly-note Navigateur du carnet : Ouvrir la note annuelle
notebook-navigator:toggle-descendants Navigateur de carnets : Afficher/masquer les éléments descendants
notebook-navigator:toggle-hidden Navigateur de bloc-notes : Afficher/masquer les dossiers, balises et notes cachés
notebook-navigator:toggle-tag-sort Navigateur de bloc-notes : basculer l'ordre de tri des balises
notebook-navigator:toggle-tags-by-selection Navigateur de carnets : Afficher/masquer les balises selon la sélection
notebook-navigator:toggle-properties-by-selection Navigateur de carnets : afficher/masquer les propriétés par sélection
notebook-navigator:toggle-compact-mode Navigateur de carnets : Activer/désactiver le mode compact
notebook-navigator:toggle-pinned-section Navigateur de bloc-notes : afficher/masquer la section épinglée
notebook-navigator:collapse-expand Navigateur de carnets : Réduire / développer tous les éléments
notebook-navigator:collapse-expand-selected-item Navigateur de bloc-notes : Réduire / développer l'élément sélectionné
notebook-navigator:new-note Navigateur de carnets : Créer une nouvelle note
notebook-navigator:new-note-from-template Navigateur de bloc-notes : Créer une nouvelle note à partir d'un modèle
notebook-navigator:move-files Navigateur de bloc-notes : Déplacer des fichiers
notebook-navigator:merge-notes Navigateur de bloc-notes : fusionner des notes
notebook-navigator:select-next-file Navigateur de bloc-notes : Sélectionner le fichier suivant
notebook-navigator:select-previous-file Navigateur de bloc-notes : sélectionner le fichier précédent
notebook-navigator:convert-to-folder-note Navigateur de carnets : Convertir en note de dossier
notebook-navigator:set-as-folder-note Navigateur de bloc-notes : Définir comme note de dossier
notebook-navigator:detach-folder-note Navigateur de bloc-notes : Détacher une note de dossier
notebook-navigator:pin-all-folder-notes Navigateur de bloc-notes : Épingler toutes les notes de dossier
notebook-navigator:delete-files Navigateur de bloc-notes : Supprimer des fichiers
notebook-navigator:add-tag Navigateur de bloc-notes : Ajouter un tag aux fichiers sélectionnés
notebook-navigator:set-property Navigateur de bloc-notes : Définir une propriété sur les fichiers sélectionnés
notebook-navigator:remove-tag Navigateur de bloc-notes : Supprimer un tag des fichiers sélectionnés
notebook-navigator:remove-all-tags Navigateur de bloc-notes : Supprimer toutes les balises des fichiers sélectionnés
notebook-navigator:rebuild-cache Navigateur de cahiers : Reconstruire le cache

9 Caractéristiques

9.1 Interface

  • Disposition en deux volets - Volet de navigation (dossiers/étiquettes/propriétés) et volet de liste (fichiers)
  • Mode à volet unique - Vues de navigation et de liste avec transitions animées
  • Volets redimensionnables - Orientation horizontale ou verticale desvolets
  • Zoom indépendant de l'interface utilisateur - Modification de l'échelle du navigateur du carnet de notes sans changer le zoom d'Obsidian
  • Vue de démarrage - Navigation d'abord ou liste d'abord
  • Prise en charge multilingue - 21 langues avec prise en charge de la mise en page RTL
  • Jeu d'icônes d'interface - Icônes d'interface utilisateur personnalisables sur l'ensemble du plugin

9.2 Navigation

  • Profils de coffre-fort - Vues filtrées multiples avec dossiers/tags/notes cachés par profil, visibilité des fichiers, bannière et raccourcis
  • Raccourcis - Notes, dossiers, balises, propriétés et recherches enregistrées, avec possibilité de les épingler et de les réorganiser
  • Notes/fichiers récents - Section des éléments récents stockés par profil de coffre-fort, éventuellement épinglés avec des raccourcis
  • Calendrier - Calendrier de notes quotidiennes avec sélection des jours, prévisualisation des images et prise en charge de la division verticale
  • Arborescence des dossiers - Navigation par expansion/réduction avec classement manuel du dossier racine
  • Arborescence des étiquettes - Étiquettes hiérarchiques avec ordre configurable de l'étiquette racine
  • Navigateur de propriétés - Parcourez les propriétés des fichiers organisées par clé et par valeur avec le nombre de fichiers, des couleurs personnalisées, des icônes et la fonction glisser-déposer
  • Révélation automatique du fichier actif - Expansion du dossier et sélection par défilement
  • Clavier et commandes - Touches de raccourci configurables, commandes de retour/avance de l'historique de sélection, commandes de fichier suivant/précédent, commandes de raccourci d'ouverture 1-9

9.3 Organisation

  • Épingler des notes - Conservez les notes importantes en haut des dossiers et des étiquettes
  • Notes de dossier - Définir/supprimer les notes de dossier, épingler les notes de dossier, ouvrir l'option dans un nouvel onglet
  • Opérations sur les balises - Ajouter/supprimer/effacer des balises, renommer/supprimer des balises, créer une note dans une balise, glisser-déposer une hiérarchie de balises
  • Tri et regroupement personnalisés - Remplacer les paramètres de tri/groupe par dossier ou étiquette
  • Apparences par dossier/tag - Lignes de titre, lignes de prévisualisation, mode compact, bascule des descendants
  • Contenu caché - Dossiers/balises/notes/fichiers cachés avec motifs, propriétés de l'objet frontal et filtrage basé sur les balises par profil de coffre-fort
  • Exclure des dossiers de la hiérarchie - Ne pas prendre en compte certains dossiers lors de la collecte des notes dans les sous-dossiers, selon le profil du coffre-fort ; les dossiers exclus restent visibles et affichent leurs notes lorsqu'ils sont sélectionnés
  • Système de couleurs et d'icônes - Couleurs des dossiers/étiquettes/propriétés/fichiers, packs d'icônes, icônes emoji/Lucide, lecture/écriture de l'objet frontal, mappage des icônes par nom de fichier et catégorie de type de fichier
  • Avertissements sur les noms - Avertit des caractères interdits dans le système de fichiers et des caractères qui rompent les liens Obsidian lors de la dénomination des fichiers et des dossiers

9.4 Affichage des fichiers

  • Prévisualisation des notes - 1 à 5 lignes de prévisualisation avec option de suppression du HTML
  • Vignettes - Images mises en avant et vignettes générées automatiquement pour les fichiers PDF, SVG et de dessin stockés dans le cache de métadonnées
  • Images externes - Téléchargements facultatifs d'images externes et de vignettes YouTube
  • Regroupement par date - Regroupement des notes par Aujourd'hui, Hier, 7 jours précédents, 30 jours précédents, mois et années lorsqu'elles sont triées par date
  • Prise en charge du frontmatter - Lecture des noms de notes et des horodatages dans les champs du frontmatter
  • Métadonnées des notes - Afficher la date de modification et les étiquettes dans la liste des fichiers
  • Propriétés personnalisées - Affichage des propriétés de la page de garde ou du nombre de mots dans la liste des fichiers, avec des modifications par dossier/étiquette et des couleurs personnalisées
  • Affichage du dossier parent - Nom et icône du dossier parent en option dans la liste des fichiers
  • Mode compact - Affichage compact lorsque l'aperçu, la date et les images sont désactivés
  • Etiquettes cliquables - Les étiquettes dans la liste des fichiers permettent de naviguer directement vers l'étiquette en question

9.5 Productivité

  • Recherche - Filtre par nom de fichier, balises, propriétés, dates, dossiers, extensions et tâches avec AND/OR/exclusions
  • Intégration d'Omnisearch - Recherche en texte intégral via Omnisearch
  • Glisser-déposer - Déplacements de fichiers, étiquetage, attribution de raccourcis, répartition de l'arborescence des étiquettes, dossiers à ressort
  • Menus contextuels - Créer des notes/dossiers/canevases/bases/dessins et exécuter des actions de fichiers/étiquettes
  • Dessins - Créer des dessins Excalidraw et Tldraw à partir des menus des volets de navigation et de liste
  • Modèles - Nouvelle note sur les commandes de modèles avec le plugin Templater
  • Opérations sur les fichiers - Créer, renommer, dupliquer, déplacer, mettre à la corbeille des fichiers et des dossiers
  • Filtrage - Exclusions de dossiers/étiquettes/notes/fichiers à l'aide de modèles et de propriétés de la matière première

10 Divulgation des réseaux et des diagnostics

Le Notebook Navigator s'exécute localement, mais certaines fonctionnalités font des requêtes HTTP à partir d'Obsidian. La journalisation du débogage au démarrage peut également écrire un fichier de diagnostic local dans votre chambre forte.

10.1 Contrôles de la mise à jour des versions (facultatif)

  • Paramètre : "Vérifier la présence d'une nouvelle version au démarrage"
  • Demande : https://api.github.com/repos/johansan/notebook-navigator/releases/latest
  • Fréquence : Au maximum une fois par 24 heures, au démarrage
  • Données : Envoie des métadonnées HTTP standard ; n'inclut pas le contenu de la chambre forte

10.2 téléchargements de packs d'icônes (optionnel)

  • Paramètre : Activer un pack d'icônes dans l'onglet Packs d'icônes
  • Requêtes : https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (manifeste, police, métadonnées)
  • Stockage : Stocké localement dans IndexedDB

10.3 Images externes, vidéos et vignettes YouTube

  • Images d'illustration (facultatif) : Contrôlé par le paramètre "Télécharger des images externes". Télécharge les images distantes et les vignettes YouTube pour les images de présentation et les stocke localement dans IndexedDB.
  • Modale de bienvenue (premier lancement) : Charge une vignette statique à partir de https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
  • Modale "Quoi de neuf" (lors de la mise à jour / à l'ouverture) : Charge les images des bannières de publication à partir de https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg pour les notes de publication qui incluent une bannière.
  • Fenêtre modale « Nouveautés » (lors d'une mise à jour / à l'ouverture) : charge les vidéos de mise à jour depuis https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 pour les notes de mise à jour qui incluent une vidéo.
  • Fenêtre modale « Quoi de neuf » (lors de l'ouverture d'une vidéo de lancement) : ouvre les vidéos de lancement à partir de https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4 afin que les navigateurs puissent les lire directement.
  • Modale "Quoi de neuf" (lors de la mise à jour / à l'ouverture) : Charge les vignettes YouTube à partir de https://img.youtube.com/vi/<id>/... pour les notes de mise à jour qui contiennent un lien YouTube.

10.4 Fichiers de débogage au démarrage (facultatif)

  • Paramètre : "Logging de débogage au démarrage"
  • Stockage : Écrit un fichier nn-debug-...md horodaté dans la racine du coffre, puis s'arrête après le démarrage. Le fichier peut se synchroniser si la racine du coffre est synchronisée.
  • Données : Comprend la date de démarrage, la version du plugin, la version minimale d'Obsidian prise en charge, la plate-forme, le nombre de caches, le nombre de files d'attente, l'état d'IndexedDB et les erreurs de diagnostic. Elles ne comprennent pas le contenu des notes, les noms des balises, les valeurs de la matière première ou la liste des fichiers de l'espace de stockage.
  • Chemins et identifiants : L'initialisation du démarrage, les diagnostics PDF et les cas d'erreur peuvent inclure l'identifiant de l'application/du coffre-fort Obsidian, les chemins PDF relatifs au coffre-fort ou les détails de la pile d'erreurs. Révisez et expurgez le fichier avant de le partager publiquement.
  • Télécharger : Notebook Navigator ne télécharge pas les fichiers de débogage. Ils ne sont partagés que si vous les téléchargez, les attachez ou les synchronisez en dehors du plugin.

10.5 Protection de la vie privée et traitement des données

  • Notebook Navigator n'envoie pas le contenu des notes, les noms de fichiers, les balises ou les fichiers de débogage à un serveur Notebook Navigator.
  • Les requêtes adressées à GitHub, YouTube et tout autre hébergeur d'images externe sont effectuées directement à partir de votre appareil et comprennent des métadonnées HTTP standard (adresse IP, agent utilisateur, etc.).
  • Les packs d'icônes et les images téléchargés sont stockés localement (IndexedDB). Les notes/fichiers récents et l'état de l'interface utilisateur sont stockés localement (Obsidian local storage).

histoire des 12 étoiles

Star History Chart


12 Contact

Notebook Navigator est conçu et entretenu par Johan Sanneblad. Johan est titulaire d'un doctorat en développement de logiciels et a travaillé dans le domaine du développement de l'innovation pour des entreprises telles que Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group et Yamaha.

N'hésitez pas à me contacter sur LinkedIn.


13 Questions ou problèmes ?

Rejoignez notre Discord pour obtenir de l'aide et discuter, ou ouvrez un problème sur ledépôt GitHub.

Les pull requests ne sont pas acceptées. Avec l'émergence du « codage agentique », il n'est plus possible de garantir que le code soumis par des tiers respecte les normes de qualité du projet ; par conséquent, toute pull request est automatiquement rejetée. Proposez plutôt vos idées sous forme de demandes de fonctionnalités : ouvrez un ticket. Consultez le fichier CONTRIBUTING.md pour plus de détails.


14 Licence

Ce projet est soumis à la licence publique générale GNU v3.0 - voir le fichier LICENSE pour plus de détails.