# Mistral : échange sur conversion répertoire Foam/Obsidian vers site static ## Comment convertir facilement et rapidement un répertoire de notes Obsidian en site internet ? Quels solutions et méthodes me conseilles tu ? 14:27 Convertir un répertoire de notes Obsidian en site web est une excellente façon de partager ou publier vos connaissances. Voici les solutions les plus efficaces et rapides, classées par simplicité et popularité : --- ### **1. Utiliser Obsidian Publish (Solution la plus simple et intégrée)** **Pour qui ?** Ceux qui veulent une solution clé en main, sans technique. - **Fonctionnement** : Obsidian propose un service payant appelé [Obsidian Publish](https://obsidian.md/publish) qui permet de publier vos notes en quelques clics. - **Avantages** : - Synchronisation automatique avec vos notes. - Mise en page propre et responsive. - Gestion des liens internes (comme dans Obsidian). - **Inconvénients** : - Payant (à partir de 8$/mois). - Pas d’hébergement personnalisé (URL du type `votrecompte.obsidian.publish`). - **Étapes** : 1. Allez dans les paramètres d’Obsidian → "Publish". 2. Sélectionnez le dossier à publier. 3. Personnalisez l’apparence et publiez. --- ### **2. Utiliser un générateur de site statique (Gratuit et personnalisable)** **Pour qui ?** Ceux qui veulent plus de contrôle et un hébergement gratuit ou personnalisé. #### **A. Quartz (Recommandé pour Obsidian)** - **Pourquoi ?** Conçu spécifiquement pour convertir des notes Obsidian en site web. - **Avantages** : - Gratuit et open source. - Prend en charge les liens internes, les tags, et la structure Obsidian. - Hébergement possible sur GitHub Pages, Netlify, Vercel, etc. - **Étapes** : 1. Installez [Quartz](https://github.com/jackyzha0/quartz) via GitHub. 2. Copiez vos notes dans le dossier `/content` de Quartz. 3. Lancez la commande pour générer le site. 4. Déployez sur GitHub Pages ou Netlify. - **Documentation** : [Lien vers le guide officiel](https://quartz.jzhao.xyz/). #### **B. Hugo + Obsidian (Alternative flexible)** - **Pourquoi ?** Hugo est un générateur de site statique ultra-rapide. - **Avantages** : - Très performant. - Thèmes personnalisables. - **Étapes** : 1. Installez [Hugo](https://gohugo.io/). 2. Utilisez un thème compatible Obsidian (ex: [Hugo-Obsidian](https://github.com/jtan189/hugo-obsidian)). 3. Exportez vos notes en Markdown depuis Obsidian. 4. Générez le site avec Hugo et déployez-le. #### **C. MkDocs (Simple et efficace)** - **Pourquoi ?** Idéal pour une documentation ou un wiki. - **Avantages** : - Configuration minimale. - Thème "Material for MkDocs" très abouti. - **Étapes** : 1. Installez [MkDocs](https://www.mkdocs.org/). 2. Placez vos notes dans le dossier `/docs`. 3. Lancez `mkdocs build` puis déployez. --- ### **3. Utiliser un script Python (Pour les technophiles)** **Pour qui ?** Ceux qui veulent automatiser la conversion avec un script personnalisé. - **Outils** : - Utilisez un script pour convertir les liens Obsidian (`[[note]]` → `[note](note.md)`). - Exemple de script : [obsidian-export](https://github.com/zoni/obsidian-export). - **Étapes** : 1. Clonez le script. 2. Exécutez-le sur votre répertoire Obsidian. 3. Déployez le résultat sur GitHub Pages ou un autre hébergeur. --- ### **4. Utiliser Notion + Super (Alternative sans Obsidian)** **Pour qui ?** Ceux qui sont ouverts à migrer vers Notion. - **Fonctionnement** : 1. Importez vos notes dans Notion. 2. Utilisez [Super.so](https://super.so/) pour transformer Notion en site web. - **Avantages** : - Interface visuelle. - Pas besoin de coder. - **Inconvénients** : - Moins fidèle à la structure Obsidian. --- ### **5. Hébergement et nom de domaine** - **Hébergement gratuit** : - [GitHub Pages](https://pages.github.com/) - [Netlify](https://www.netlify.com/) - [Vercel](https://vercel.com/) - **Nom de domaine** : - Achetez un nom chez [Namecheap](https://www.namecheap.com/) ou [Gandi](https://www.gandi.net/) et liez-le à votre hébergeur. --- ### **Résumé des options** Solution Coût Technique Personnalisation Hébergement Obsidian Publish Payant Aucune Limitée Obsidian Quartz Gratuit Moyenne Élevée GitHub/Netlify Hugo Gratuit Moyenne Élevée GitHub/Netlify MkDocs Gratuit Faible Moyenne GitHub/Netlify Script Python Gratuit Élevée Totale À choisir Notion + Super Payant Aucune Limitée Super.so --- ### **Recommandation selon votre profil** - **Débutant/rapide** : Obsidian Publish. - **Gratuit et personnalisable** : Quartz ou Hugo. - **Automatisation avancée** : Script Python. --- **Besoin d’aide pour choisir ou configurer une solution ?** Dites-moi quel est votre niveau technique et vos besoins précis (ex: blog, wiki, portfolio), je peux vous guider étape par étape ! 14:27 ## Je souhaite une solution simple et open source où je peux définir mon propre template pour le site. Je trouve Mkdocs très intéressant et l'extension Material très aboutie, mais je ne sais pas si je peux réorganiser les pages pour disposer d'un site minimaliste dans un esprit blog simple. Je souhaite héberger ce site sur un serveur perso qui supporte HTML, CSS, JS et PHP. 14:32 Vous avez un excellent choix avec **MkDocs + Material for MkDocs** pour un site minimaliste et personnalisable, hébergé sur votre serveur perso. Voici comment procéder pour obtenir un rendu "blog" épuré, tout en gardant la puissance de MkDocs et la flexibilité du template Material. --- ## **1. Pourquoi MkDocs + Material est adapté à votre besoin ?** - **Minimaliste** : Le thème Material est sobre et moderne, facile à adapter. - **Open source et gratuit** : Pas de coût, communauté active. - **Personnalisation** : Vous pouvez redéfinir les templates, les CSS et la structure. - **Export en HTML/JS/CSS** : Parfait pour un serveur perso (pas besoin de PHP, mais compatible si besoin). - **Gestion des notes** : Les fichiers Markdown sont organisés comme dans Obsidian. --- ## **2. Étapes pour un site "blog" minimaliste** ### **A. Installation et configuration de base** 1. **Installez MkDocs** (nécessite Python) : bash Copier `pip install mkdocs mkdocs-material` 2. **Créez un nouveau projet** : bash Copier `mkdocs new mon-blog cd mon-blog` 3. **Activez le thème Material** : Éditez `mkdocs.yml` et ajoutez : yaml Copier `theme: name: material features: - navigation.top # Barre de navigation en haut` --- ### **B. Personnalisation pour un esprit "blog"** #### **1. Structure des pages** - **Dossier `docs/`** : Organisez vos notes comme un blog, par exemple : Copier `docs/ ├── index.md # Page d'accueil (liste des articles) ├── articles/ │ ├── 2023-10-01-mon-premier-article.md │ ├── 2023-10-02-deuxieme-article.md │ └── ... └── about.md # Page "À propos"` - **Fichier `index.md`** : Utilisez des liens vers vos articles pour simuler une page de blog : markdown Copier `# Mon Blog ## Derniers articles - [Mon premier article](articles/2023-10-01-mon-premier-article.md) - [Deuxième article](articles/2023-10-02-deuxieme-article.md)` #### **2. Personnalisation du template** - **Override des templates** : Créez un dossier `overrides` à la racine de votre projet et copiez-y les fichiers à modifier depuis le [thème Material](https://github.com/squidfunk/mkdocs-material/tree/master/material/templates). Exemple pour une page d'accueil personnalisée : Copier `mon-blog/ ├── mkdocs.yml ├── docs/ └── overrides/ └── main.html # Copiez et modifiez ce template` Dans `mkdocs.yml`, ajoutez : yaml Copier `theme: custom_dir: overrides` - **CSS personnalisé** : Créez un fichier `docs/stylesheets/extra.css` et liez-le dans `mkdocs.yml` : yaml Copier `extra_css: - stylesheets/extra.css` Exemple de CSS pour un style minimaliste : css Copier `/* Masquer la sidebar si vous voulez un look "blog" */ .md-sidebar { display: none; } /* Style pour les cartes d'articles */ .md-content__inner { max-width: 800px; margin: 0 auto; padding: 2rem; }` #### **3. Configuration pour un rendu "blog"** - **Désactivez la table des matières globale** : yaml Copier `theme: features: - navigation.top - navigation.expand # Optionnel palette: - scheme: default toggle: icon: material/weather-night name: Passer en mode sombre` - **Ajoutez un plugin pour les dates** (optionnel) : Installez [mkdocs-simple-blog](https://github.com/frissdiegurke/mkdocs-simple-blog) pour gérer les articles comme un blog : bash Copier `pip install mkdocs-simple-blog` Puis dans `mkdocs.yml` : yaml Copier `plugins: - blog: blog_dir: articles post_date_format: "dd/MM/yyyy"` --- ### **C. Génération et déploiement** 1. **Générez le site** : bash Copier `mkdocs build` Le résultat sera dans le dossier `site/` (HTML/CSS/JS statiques). 2. **Copiez le dossier `site/` sur votre serveur perso** : - Utilisez FTP, SCP ou un gestionnaire de fichiers pour uploader le contenu sur votre serveur. - Placez-le dans le répertoire racine de votre hébergement (ex: `/var/www/html/mon-blog`). --- ### **D. Exemple de `mkdocs.yml` complet** yaml Copier `site_name: Mon Blog Minimaliste site_url: https://votre-domaine.com/mon-blog theme: name: material custom_dir: overrides features: - navigation.top palette: - scheme: default toggle: icon: material/weather-night name: Passer en mode sombre extra_css: - stylesheets/extra.css plugins: - blog: blog_dir: articles post_date_format: "dd/MM/yyyy"` --- ## **3. Résultat attendu** - Une **page d'accueil** listant vos articles comme un blog. - Un **design épuré** grâce au CSS personnalisé. - Une **navigation simple** en haut de page. - **100% statique** : compatible avec n'importe quel serveur (même sans PHP). --- ## **4. Aller plus loin** - **Ajouter un flux RSS** : Utilisez le plugin [mkdocs-rss-plugin](https://github.com/Guts/mkdocs-rss-plugin) pour générer un flux RSS. - **Commentaires** : Intégrez un outil comme [Disqus](https://disqus.com/) ou [Commento](https://commento.io/) via JavaScript. - **Recherche** : Activez la recherche avec : yaml Copier `theme: features: - search.suggest - search.highlight` --- ## **5. Ressources utiles** - [Documentation Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) - [Exemple de blog avec MkDocs](https://github.com/frissdiegurke/mkdocs-simple-blog) - [Templates personnalisés](https://squidfunk.github.io/mkdocs-material/customization/#overriding-templates) --- **Besoin d'aide pour adapter un template ou configurer un détail ?** Dites-moi ce que vous souhaitez modifier (ex: en-tête, pied de page, mise en page des articles), je peux vous fournir des extraits de code ou des conseils ciblés ! 14:32 ## Dans une vision minimaliste et simple, je gère mes notes dans Obsidian et Foam (VS Code). Je souhaite dédier un répertoire avec des fichiers markdown dedans à la publication sur mon site. Cela correspond à un ensemble de pages spécifiques que je souhaite publier qui se trouvent dans /projets/site/content. Si j'utilise Mkdocs, comment organiser mes fichiers et répertoires pour faire cela efficacement sans casser mon architecture et m'éparpiller ? 14:40 Pour publier **un sous-ensemble spécifique de vos notes** (par exemple, `/projets/site/content`) avec MkDocs, tout en gardant une organisation claire et sans perturber votre workflow Obsidian/Foam, voici une méthode **minimaliste, efficace et non intrusive** : --- ## **1. Structure recommandée** L’idée est de **séparer clairement** : - Vos notes **privées** (Obsidian/Foam) ; - Vos notes **publiques** (pour MkDocs). Voici comment organiser vos fichiers : Copier ``votre-depot/ ├── notes/ # Dossier racine de vos notes Obsidian/Foam │ ├── projets/ │ │ ├── site/ │ │ │ └── content/ # **Dossier dédié aux pages à publier** │ │ │ ├── index.md │ │ │ ├── article1.md │ │ │ └── article2.md │ ├── autres-notes/ # Notes privées (non publiées) │ └── ... └── site/ # **Dossier dédié à MkDocs** (à la racine ou ailleurs) ├── docs/ # **Symlink ou copie de `/projets/site/content`** │ ├── index.md # -> lien vers `/projets/site/content/index.md` │ ├── article1.md # -> lien vers `/projets/site/content/article1.md` │ └── article2.md ├── mkdocs.yml # Configuration MkDocs └── overrides/ # Templates personnalisés (optionnel)`` --- ## **2. Méthode 1 : Utiliser des liens symboliques (Recommandé)** **Pourquoi ?** - Pas de duplication de fichiers. - Modifiez vos notes dans Obsidian/Foam, les changements sont automatiquement reflétés dans MkDocs. **Étapes :** 1. **Créez un dossier `site/`** à la racine de votre dépôt (ou ailleurs). 2. **Dans `site/docs/`**, créez des liens symboliques vers `/projets/site/content` : bash Copier `cd site/ mkdir -p docs ln -s ../../notes/projets/site/content/* docs/` - Sous Windows (avec PowerShell) : powershell Copier `cd site\docs New-Item -ItemType SymbolicLink -Name "index.md" -Target "..\..\notes\projets\site\content\index.md" # Répétez pour chaque fichier ou utilisez un script.` 3. **Configurez MkDocs** (`site/mkdocs.yml`) pour utiliser ce dossier : yaml Copier `docs_dir: docs site_name: Mon Site nav: - Accueil: index.md - Article 1: article1.md` **Avantages :** - Pas de duplication. - Modifiez vos notes dans Obsidian/Foam, MkDocs voit les changements. **Inconvénient :** - Les liens symboliques peuvent être moins pratiques sous Windows (mais fonctionnent). --- ## **3. Méthode 2 : Script de synchronisation (Alternative)** Si les liens symboliques ne vous conviennent pas, utilisez un script pour **copier** les fichiers avant de générer le site. **Exemple de script (`sync_site.sh`)** : bash Copier `#!/bin/bash # Copie les fichiers de /projets/site/content vers site/docs rsync -av --delete ../notes/projets/site/content/ ./docs/ mkdocs build` - Exécutez-le avant chaque génération : bash Copier `chmod +x sync_site.sh ./sync_site.sh` --- ## **3. Configuration de MkDocs** ### **Fichier `mkdocs.yml` minimaliste** yaml Copier `site_name: Mon Site Minimaliste docs_dir: docs # Dossier contenant vos notes publiées use_directory_urls: false # URLs plus simples (ex: site.com/article1.md) theme: name: material features: - navigation.top nav: - Accueil: index.md - Projets: - Article 1: article1.md - Article 2: article2.md` ### **Personnalisation pour un rendu sobre** - **Désactivez la sidebar** (pour un look "blog") : yaml Copier `theme: features: - navigation.top extra_css: - stylesheets/extra.css # Pour masquer la sidebar` - **CSS personnalisé** (`docs/stylesheets/extra.css`) : css Copier `/* Masquer la sidebar */ .md-sidebar { display: none !important; } /* Conteneur central */ .md-content__inner { max-width: 800px; margin: 0 auto; padding: 2rem; }` --- ## **4. Workflow recommandé** 1. **Éditez vos notes** dans Obsidian/Foam (`/projets/site/content/`). 2. **Générez le site** : - Avec liens symboliques : `mkdocs build` (les changements sont automatiques). - Avec script : `./sync_site.sh`. 3. **Déployez** le dossier `site/` sur votre serveur. --- ## **5. Points clés à respecter** - **Ne modifiez pas les fichiers dans `site/docs/`** : toujours éditer dans `/projets/site/content/` pour éviter les conflits. - **Ignorez le dossier `site/`** dans Git (sauf si vous voulez versionner la config MkDocs) : gitignore Copier `site/site/ # Dossier généré par MkDocs` - **Utilisez des liens relatifs** dans vos notes Markdown pour les images/liens : markdown Copier `![image](./images/photo.png) # Pas de chemins absolus` --- ## **6. Exemple de structure concrète** Copier `votre-depot/ ├── notes/ │ └── projets/ │ └── site/ │ └── content/ │ ├── index.md │ └── article1.md ├── site/ │ ├── docs/ # Liens symboliques ou copies │ │ ├── index.md # -> ../../notes/projets/site/content/index.md │ │ └── article1.md │ ├── mkdocs.yml │ └── overrides/ └── .gitignore` --- ## **7. Bonus : Automatisation avec GitHub Actions (optionnel)** Si vous utilisez GitHub, ajoutez un workflow pour générer le site à chaque commit : yaml Copier `# .github/workflows/deploy.yml name: Déployer le site on: push: branches: [ main ] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: pip install mkdocs mkdocs-material - run: ./sync_site.sh # Si vous utilisez le script - run: mkdocs build - run: rsync -av site/ user@votre-serveur:/chemin/vers/le/site` --- ## **8. Résumé des avantages** Méthode Avantages Inconvénients **Liens symboliques** Pas de duplication, synchronisé. Moins pratique sous Windows. **Script de copie** Portable, simple. Duplication temporaire des fichiers. --- **Question pour vous :** - Préférez-vous les liens symboliques ou un script de copie ? - Souhaitez-vous un exemple de template MkDocs pour un rendu "blog" épuré ? Je peux vous fournir des extraits de code ou des détails supplémentaires selon votre choix ! 14:40 ## Pourquoi ne pas configurer Mkdocs pour pointer directement vers le dossier contenant mes fichiers avec par exemple : "docs_dir: ../../../notes/projets/site/content" ? 14:43 Vous avez tout à fait raison : **techniquement, c'est possible** de configurer MkDocs pour pointer directement vers votre dossier de notes avec `docs_dir: ../../notes/projets/site/content`. Cependant, cette approche a des **avantages et des inconvénients** qu'il est important de peser pour un workflow optimal et durable. Voici une analyse détaillée : --- ## **1. Pourquoi ça marche ?** - MkDocs acceptera sans problème un chemin relatif ou absolu pour `docs_dir`. - Vous n'aurez pas besoin de liens symboliques ou de scripts de copie. - Exemple de configuration : yaml Copier `# mkdocs.yml docs_dir: ../../notes/projets/site/content site_name: Mon Site nav: - Accueil: index.md` --- ## **2. Avantages de cette méthode** - **Simplicité** : Pas besoin de synchroniser ou de créer des liens. - **Centralisation** : Tout est géré depuis un seul dossier. - **Pas de duplication** : Vos notes restent à leur place d'origine. --- ## **3. Inconvénients et risques potentiels** ### **A. Problèmes de chemins relatifs** - **Les liens internes** dans vos notes Markdown (ex: `[[Autre note]]` ou `[texte](chemin/relatif)`) risquent de ne pas fonctionner correctement une fois publiées, car MkDocs génère une structure de site différente de celle d'Obsidian/Foam. - **Exemple** : - Dans Obsidian, un lien `[[Autre note]]` ou `[texte](../autre-dossier/note.md)` peut ne pas être résolu correctement par MkDocs, surtout si la structure du site généré diffère de celle de votre dépôt. ### **B. Pollution du dossier de notes** - MkDocs va générer des fichiers temporaires (comme `.pages`) ou des caches dans votre dossier de notes, ce qui peut : - **Encombrer** votre espace de travail Obsidian/Foam. - **Créer des conflits** avec Git ou d'autres outils. ### **C. Difficulté à personnaliser le site** - Si vous voulez ajouter des **pages spécifiques à MkDocs** (ex: une page "À propos" ou un template personnalisé), vous devrez les placer dans votre dossier de notes, ce qui mélange **contenu privé et public**. - Impossible d'utiliser des **overrides de templates** ou des fichiers statiques (CSS/JS) sans les mélanger avec vos notes. ### **D. Risque d'erreur** - Si vous exécutez `mkdocs build` depuis un autre répertoire, les chemins relatifs peuvent casser. - Les plugins MkDocs (comme `mkdocs-simple-blog`) s'attendent souvent à une structure standard (`docs/`). ### **E. Déploiement moins flexible** - Vous ne pourrez pas facilement **pré-traiter** vos notes avant publication (ex: supprimer des métadonnées Obsidian, ajuster les liens, etc.). --- ## **4. Quand cette méthode est-elle acceptable ?** - Si : - Vous n'utilisez **aucun lien interne** dans vos notes (ou seulement des liens relatifs compatibles avec MkDocs). - Vous ne voulez **aucune personnalisation** avancée (pas de templates, pas de CSS/JS additionnels). - Vous acceptez que MkDocs écrive des fichiers dans votre dossier de notes. --- ## **5. Solution hybride (recommandée)** Pour combiner **simplicité et robustesse**, voici une alternative qui limite les inconvénients : ### **A. Utilisez un sous-dossier dédié dans `docs_dir`** 1. Créez un sous-dossier **spécifique pour MkDocs** dans votre dossier de notes : Copier ``notes/ └── projets/ └── site/ ├── content/ # Vos notes à publier └── mkdocs/ # Configuration et fichiers statiques pour MkDocs ├── docs/ # **Symlink vers `content/`** ├── mkdocs.yml └── overrides/`` 2. Dans `mkdocs.yml` : yaml Copier `docs_dir: docs # Pointe vers le symlink` 3. Créez un lien symbolique : bash Copier `cd notes/projets/site/mkdocs ln -s ../content docs` ### **B. Avantages de cette approche** - **Séparation claire** entre configuration MkDocs et notes. - **Pas de pollution** du dossier `content/`. - **Flexibilité** pour ajouter des fichiers statiques ou des templates. --- ## **6. Recommandation finale** Si vous tenez à utiliser `docs_dir: ../../notes/projets/site/content` : 1. **Testez d'abord** avec une copie de vos notes pour vérifier que : - Les liens internes fonctionnent. - Aucune fichier indésirable n'est créé dans `content/`. 2. **Évitez les plugins** qui écrivent dans `docs_dir`. 3. **Documentez** cette configuration pour éviter les surprises plus tard. --- **Alternative encore plus simple et sûre :** Utilisez un **script minimal** pour copier les fichiers avant la génération (comme proposé précédemment). Cela vous donne un contrôle total sans risque de casser votre workflow Obsidian/Foam. --- **Question :** Souhaitez-vous que je vous fournisse un exemple de script ou de configuration pour tester cette approche en toute sécurité ? Ou préférez-vous opter pour la solution hybride avec un sous-dossier dédié ? 14:43 ## Est-ce que Mkdocs gère les liens de type [[ma_page]] ? Je vais privilégier 2 dossiers séparés et la copie des fichiers dans le dossier Mkdocs avant le build du site. Peux-tu me proposer un script Python pour faire cela ? 14:46 Voici un script Python **simple et robuste** pour copier vos fichiers Markdown depuis votre dossier Obsidian/Foam (`notes/projets/site/content/`) vers le dossier `docs/` de MkDocs, **en convertissant les liens Wikilinks (`[[ma_page]]`) en liens Markdown standard (`[ma_page](ma_page.md)`)**. Ce script : 1. Copie uniquement les fichiers `.md` ; 2. Convertit les liens `[[...]]` en liens Markdown ; 3. Préserve la structure des sous-dossiers ; 4. Ignore les fichiers/dossiers cachés (comme `.obsidian/`). --- ### **Script Python : `sync_mkdocs.py`** python Copier ```python import os import shutil import re from pathlib import Path # Chemins (à adapter selon votre structure) SOURCE_DIR = Path("../notes/projets/site/content") # Dossier source (Obsidian/Foam) TARGET_DIR = Path("docs") # Dossier cible (MkDocs) def convert_wikilinks_to_markdown(content: str) -> str: """Convertit les liens [[page]] en [page](page.md).""" def replace_match(match): target = match.group(1) # Gère les alias : [[page|alias]] -> [alias](page.md) if "|" in target: page, alias = target.split("|", 1) return f"[{alias.strip()}]({page.strip()}.md)" else: return f"[{target.strip()}]({target.strip()}.md)" # Pattern pour [[page]] ou [[page|alias]] pattern = r"\[\[([^\]]+)\]\]" return re.sub(pattern, replace_match, content) def sync_folders(): # Nettoie le dossier cible if TARGET_DIR.exists(): shutil.rmtree(TARGET_DIR) TARGET_DIR.mkdir(parents=True) # Copie et convertit les fichiers for md_file in SOURCE_DIR.rglob("*.md"): # Ignore les fichiers/dossiers cachés if any(part.startswit(".") for part in md_file.parts): continue # Crée la structure de dossiers dans la cible rel_path = md_file.relative_to(SOURCE_DIR) target_path = TARGET_DIR / rel_path target_path.parent.mkdir(parents=True, exist_ok=True) # Lit et convertit le contenu with open(md_file, "r", encoding="utf-8") as f: content = f.read() content = convert_wikilinks_to_markdown(content) # Écrit le fichier dans la cible with open(target_path, "w", encoding="utf-8") as f: f.write(content) print(f"Copié et converti : {rel_path}") if __name__ == "__main__": sync_folders() print("Synchronisation terminée !") ``` --- ### **Comment l'utiliser ?** 1. Placez ce script dans le dossier racine de votre projet MkDocs (à côté de `mkdocs.yml`). 2. Installez les dépendances (si besoin) : bash Copier `pip install pathlib # Déjà inclus dans Python 3.4+` 3. Exécutez-le avant chaque build : bash Copier `python sync_mkdocs.py mkdocs build` --- ### **Fonctionnalités clés** - **Conversion des liens** : - `[[ma_page]]` → `[ma_page](ma_page.md)` - `[[ma_page|Mon Lien]]` → `[Mon Lien](ma_page.md)` - **Préservation des sous-dossiers** : - `content/sous-dossier/page.md` → `docs/sous-dossier/page.md` - **Nettoyage automatique** : - Supprime l'ancien contenu de `docs/` avant la copie. --- ### **Exemple de structure avant/après** Copier `notes/ └── projets/ └── site/ └── content/ ├── index.md # Contient [[ma_page]] └── ma_page.md docs/ # Après exécution du script ├── index.md # Contient [ma_page](ma_page.md) └── ma_page.md` --- ### **Personnalisation possible** - **Exclure des fichiers** : Ajoutez une liste d'exclusions (ex: `exclude = ["brouillon.md"]`) et modifiez la boucle pour les ignorer. - **Gérer les images** : Ajoutez une copie des fichiers `.png`/`.jpg` avec : python Copier `for img_file in SOURCE_DIR.rglob("*.png"): target_path = TARGET_DIR / img_file.relative_to(SOURCE_DIR) shutil.copy2(img_file, target_path)` --- ### **Intégration avec MkDocs** 1. **`mkdocs.yml`** : yaml Copier `docs_dir: docs site_name: Mon Site nav: - Accueil: index.md` 2. **Génération du site** : bash Copier `python sync_mkdocs.py && mkdocs build` --- ### **Pourquoi ce script ?** - **Fiabilité** : Pas de liens cassés grâce à la conversion automatique. - **Propreté** : Séparation claire entre notes privées et publiques. - **Flexibilité** : Vous pouvez ajouter d'autres transformations (ex: métadonnées YAML). --- **Besoin d'ajuster quelque chose ?** Dites-moi si vous voulez : - Gérer des cas spécifiques de liens ; - Ajouter des options en ligne de commande ; - Automatiser le déploiement (ex: avec GitHub Actions). 14:46 Est-ce que Mkdocs gère les liens de type [[ma_page]] ? 14:47 Non, **MkDocs ne gère pas nativement les liens de type `[[ma_page]]`** (appelés _wikilinks_), qui sont spécifiques à des outils comme Obsidian, Foam ou Wikis. --- ### **Comportement par défaut de MkDocs** - Si vous laissez des liens `[[ma_page]]` dans vos fichiers Markdown, **MkDocs les affichera tels quels** dans le HTML généré, sans les convertir en liens cliquables. - MkDocs s'attend à des liens Markdown standard : markdown Copier `[texte du lien](ma_page.md)` --- ### **Solutions pour utiliser MkDocs avec des wikilinks** #### **1. Conversion automatique (recommandé)** Utilisez un script (comme celui que je vous ai fourni précédemment) pour **convertir les `[[ma_page]]` en `[ma_page](ma_page.md)` avant de générer le site**. - **Avantages** : - Compatible avec tous les thèmes MkDocs. - Pas de dépendance supplémentaire. - Contrôle total sur la conversion. #### **2. Plugin tiers (optionnel)** Il existe des plugins comme [`mkdocs-wikilinks-plugin`](https://github.com/jldez/mkdocs-wikilinks-plugin) qui ajoutent un support partiel des wikilinks. - **Installation** : bash Copier `pip install mkdocs-wikilinks-plugin` - **Configuration** (`mkdocs.yml`) : yaml Copier `plugins: - wikilinks` - **Limitations** : - Moins flexible que la conversion manuelle. - Peut ne pas gérer les alias (`[[page|alias]]`) ou les chemins complexes. --- ### **Exemple de conversion manuelle** Wikilink (Obsidian) Lien Markdown (MkDocs) `[[ma_page]]` `[ma_page](ma_page.md)` `[[ma_page Mon Lien]]` `[[sous-dossier/page]]` `[page](sous-dossier/page.md)` --- ### **Recommandation** Pour un workflow **simple et fiable**, privilégiez la **conversion automatique** via un script avant le build. Cela évite les surprises et garantit une compatibilité totale avec MkDocs et ses plugins. --- **Besoin d'aide pour adapter le script ou tester la conversion ?** Dites-moi quels cas de liens vous utilisez (alias, chemins relatifs, etc.), je peux vous fournir une version optimisée !