🛠️ Le moteur de publication
À quoi il sert
Le moteur sépare le contenu de sa présentation. Les notes restent dans leur propre dépôt, le code du site dans un autre : on peut écrire sans toucher au code, et publier plusieurs sites avec le même moteur.
flowchart LR N["Notes Obsidian<br/>et configuration du site"] --> M["Moteur<br/>Astro + Starlight"] M --> D["Site statique"] D --> H["Hébergement web"]
Ce qu’il apporte au lecteur
- Des définitions au survol. Survolez le mot VRAM : sa définition s’affiche sans quitter la page.
- Des schémas interactifs. Les diagrammes Mermaid se zooment, se déplacent et s’ouvrent en plein écran.
- Les références entrantes. Chaque page liste celles qui la citent.
- Les prérequis de lecture. Un encadré indique quoi lire d’abord.
- Le français et l’anglais. Les liens internes d’une page traduite mènent à la version traduite lorsqu’elle existe.
- La fraîcheur affichée. Le bas de page indique les dates de modification et de vérification.
Ce qu’il apporte à l’auteur
- L’écriture Obsidian conservée : liens
[[...]], modèles, encadrés, formules et schémas Mermaid. - Une configuration côté contenu. Le titre, l’adresse, les langues et le menu se règlent dans le fichier
site.config.jsondu coffre. - Les notes privées protégées. Le dossier
_private/et les fichiers exclus ne sont jamais publiés. - Une publication incrémentale. Seuls les fichiers modifiés sont envoyés au serveur, par FTPS ou SFTP.
- Des contrôles. Un audit signale les liens internes cassés.
L’essayer
Il faut Node.js 22 ou plus récent. Depuis un dossier voisin de votre coffre Obsidian :
git clone https://github.com/DamienBecherini/starlight-obsidian-engine.gitcd starlight-obsidian-enginecp .env.example .env # indiquer VAULT_PATH=../votre-coffrenpm installnpm run devLe README du projet décrit la configuration et la mise en ligne.
Ses limites
- La protection par mot de passe du site ne fonctionne que sur un hébergement Apache.
- Il suppose un coffre organisé avec des métadonnées en tête de chaque note.
Dépôt GitHub : DamienBecherini/starlight-obsidian-engine, sous licence 0BSD, réutilisable sans condition.
Mémoire à haut débit attachée au GPU, qui stocke poids, KV Cache et buffers ; capacité et bande passante déterminent quels modèles tournent sans offloading.