Aller au contenu

🛠️ 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.json du 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 :

Fenêtre de terminal
git clone https://github.com/DamienBecherini/starlight-obsidian-engine.git
cd starlight-obsidian-engine
cp .env.example .env # indiquer VAULT_PATH=../votre-coffre
npm install
npm run dev

Le 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.

Donner mon avis

Tout est facultatif : une seule réponse suffit. Ce site n'envoie rien : c'est vous qui envoyez, par le moyen de votre choix.

Votre notePas de note
Votre avis porte sur
Sur quoi ? (plusieurs choix possibles)
Ce qui sera envoyé
Envoyer par e-mail

Privé, sans compte : ouvre votre messagerie avec le message prêt, pour ia-on-prem@damien.becherini.fr.

Ouvrir un ticket GitHub ↗

Public, avec un compte GitHub. Vous relisez le ticket avant de le publier.

Pour le coller où vous voulez.

Donnez au moins une note, un sujet ou un message pour pouvoir envoyer.