Related Sidebar

Plugin Obsidian custom qui affiche automatiquement dans la sidebar droite le contenu d'un fichier lié à la note active.

Fonctionnement

Quand vous ouvrez une note, le plugin cherche un fichier lié selon deux mécanismes, dans cet ordre :

1. Propriété related de la note elle-même — si le frontmatter contient related: Mon Fichier, ce fichier est affiché dans la sidebar.
2. Propriété related de la note de dossier — si la note n'a pas de related, le plugin remonte les dossiers parents à la recherche d'une note de dossier (NomDuDossier/NomDuDossier.md) qui, elle, possède une propriété related. Ce mécanisme permet de définir un fichier lié par défaut pour tout un dossier.

Si aucun fichier lié n'est trouvé, la sidebar affiche le message "Aucun fichier lié défini."

Utilisation

Ajoutez la propriété related dans le frontmatter d'une note :

---
related: Nom du fichier lié
---

La valeur accepte un nom de fichier (sans .md), un chemin relatif, ou un lien Obsidian ([[Nom du fichier]]).

Bouton "Ouvrir"

L'en-tête de la sidebar affiche le nom du fichier lié et un bouton Ouvrir pour l'afficher dans un nouvel onglet.

Commande

La palette de commandes expose la commande "Ouvrir le panneau Fichier lié" pour forcer l'ouverture de la sidebar si elle a été fermée.

Structure du projet

related-sidebar/
├── src/
│   └── main.ts          # Source TypeScript
├── main.js              # Bundle compilé (généré par esbuild)
├── styles.css           # Styles du panneau sidebar
├── manifest.json        # Métadonnées du plugin
└── esbuild.config.mjs   # Configuration du build

Développement

Prérequis : Node.js ≥ 18 (testé avec Node.js 22)

npm install
npm run dev   # watch + rebuild automatique
npm run build # build de production