Intégration de coffre Obsidian
Modifiez le contenu de Zer0-Mistakes comme un coffre Obsidian et obtenez un rendu identique sur GitHub Pages.
Table of Contents
Intégration de coffre Obsidian
Le dépôt Zer0-Mistakes est un coffre Obsidian entièrement fonctionnel. Ouvrez la racine du dépôt (ou tout sous-dossier contenant des notes) comme coffre et chaque fichier Markdown devient modifiable avec les wiki-links, intégrations, encarts, vue graphe et rétroliens d’Obsidian. Les mêmes fichiers s’affichent sur GitHub Pages avec une présentation équivalente — pas de duplication, pas d’étape de synchronisation distincte.
Dans cette section
| Page | Contenu abordé |
|---|---|
| Prise en main | Ouvrir le dépôt comme coffre, plugins recommandés, règles de frontmatter. |
| Référence de syntaxe | Chaque fonctionnalité Obsidian et son rendu sur le site. |
| Vue graphe | Carte interactive à disposition dynamique de chaque page et wiki-link. |
| Flux de rédaction | Boucle note quotidienne → commit → publication. |
| Dépannage | Liens brisés, intégrations manquantes, conflits. |
Fonctionnement
L’intégration comporte deux volets :
- Émission de données côté serveur. Un modèle Liquid émet
assets/data/wiki-index.jsonà chaque build Jekyll, listant chaque document de collection et chaque page autonome (titre, nom de base, permalien, tags, alias, extrait). Cela fonctionne sur le build GitHub Pagesremote_themepar défaut, sans plugin personnalisé requis. - Résolveur côté client.
assets/js/obsidian-wiki-links.jscharge l’index dans le navigateur et réécrit⟦10⟧,⟦11⟧, les#tagsen ligne et les encarts Obsidian sous forme de citations en HTML stylisé avec Bootstrap. Le résultat est indiscernable d’un rendu côté serveur pour les lecteurs, et permet à l’intégration de fonctionner sur GH Pages standard sans workflow CI personnalisé.
Pour les utilisateurs qui construisent eux-mêmes avec Jekyll standard (sans gem github-pages), un plugin Ruby optionnel (_plugins/obsidian_links.rb) réalise les mêmes transformations côté serveur pour un SEO légèrement meilleur. Consultez la référence de syntaxe pour la matrice complète des fonctionnalités.
Voir aussi
- [[Getting Started with the Obsidian Vault]]
- [[Obsidian Syntax Reference]]
- [[Obsidian Graph View]]
- [[Obsidian Authoring Workflow]]
- [[Obsidian Integration Troubleshooting]]
- [[front-matter]]
- [[Installation]]