Aller au contenu

Récapitulatif : Tâches quotidiennes et mises à jour

Auteur : Sylvain Denis Date : Avril 2026

Workflow quotidien (utilisation normale)

Comment ajouter ou modifier du contenu

C'est ultra-simple. Voici ce que tu fais :

  1. Ouvre Obsidian

    • Lance Obsidian
    • Ton vault documentations devrait s'ouvrir automatiquement
    • Sinon, ouvre-le manuellement

    • Crée ou modifie tes pages

    • Navigue dans le dossier docs/

    • Crée de nouvelles notes ou modifie les existantes
    • Ajoute des images, du texte, des tableaux, etc.
    • Utilise le Markdown normal

    • Sauvegarde

    • Ctrl+S (ou sauvegarde automatique)

    • C'EST TOUT !

    • Le plugin Git sauvegarde automatiquement toutes les 5 minutes

    • GitLab reconstruit le site automatiquement en 2-3 minutes
    • Ton site est à jour 7-8 minutes après ta modification

Tu n'as JAMAIS besoin d'ouvrir un terminal au quotidien.

Délais à connaître

Action Délai
Tu sauvegardes dans Obsidian Instantané
Plugin Git push vers GitLab Max 5 minutes (auto)
GitLab reconstruit le site 2-3 minutes
Total : modification → site en ligne 7-8 minutes

Note : Si tu es pressé, tu peux forcer un push immédiat (voir plus bas).

Tâches courantes

1. Ajouter un nouveau projet

Dans Obsidian :

  1. Va dans le dossier approprié (ex: docs/projets-laser/)
  2. Clic droit → "New note"
  3. Nomme-la (ex: boite-laser)
  4. Utilise ton template projet fab-c
  5. Ajoute le contenu, les images
  6. Sauvegarde

Résultat : Le projet apparaît automatiquement dans le menu du site en 7-8 minutes.

2. Ajouter des images à un projet

Méthode recommandée : images dans le même dossier

  1. Crée un sous-dossier pour les images (ex: docs/projets-laser/boite-laser/)
  2. Place tes images dedans

  3. Dans ton fichier Markdown, référence-les :

    ![Description](boite-laser/image1.jpg)

Méthode alternative : dossier images global

  1. Place tes images dans docs/images/

  2. Référence :

    ![Description](../images/mon-image.jpg)

Obsidian gère les images par glisser-déposer :

  • Glisse une image depuis ton explorateur de fichiers
  • Dépose-la dans la note Obsidian
  • Obsidian copie automatiquement l'image et insère le lien

3. Modifier la structure du site (menus, sections)

Ajouter une nouvelle section :

  1. Crée un nouveau dossier dans docs/ (ex: docs/formations/)
  2. Crée un fichier index.md dedans
  3. Sauvegarde

Résultat : La nouvelle section apparaît automatiquement dans le menu.

Renommer une section :

  1. Renomme le dossier dans Obsidian
  2. Sauvegarde

Note : Attention aux liens cassés si tu renommes. Obsidian peut aider à mettre à jour les liens automatiquement.

4. Push manuel (si tu es pressé)

Si tu veux publier immédiatement sans attendre 5 minutes :

Dans Obsidian :

  1. Ouvre la Palette de commandes

    • Menu Affichage → Palette de commandes
    • Ou raccourci clavier (configure-le dans Paramètres → Raccourcis)
    • Tape : git commit

  2. Sélectionne : "Git: Commit all changes with specific message"

  3. Entre un message : Ajout projet X

  4. Appuie sur Entrée

Résultat : Push immédiat. Le site sera en ligne en 2-3 minutes.

Maintenance périodique

Chaque semaine : Vérifier les mises à jour

Rien à faire !

Git gère tout automatiquement. Mais si tu veux vérifier :

  1. Ouvre GitLab : https://gitlab.com/sylden73/documentations
  2. Onglet "Construire" → "Pipelines"
  3. Vérifie que les derniers pipelines sont verts ✓

Chaque mois : Backup manuel (recommandé)

Même si GitLab sauvegarde tout, une copie locale supplémentaire ne fait jamais de mal.

En ligne de commande :

# Copie du dossier avec date
cp -r ~/chemin/vers/documentations ~/Backups/documentations-$(date +%Y%m%d)

Ou avec ton gestionnaire de fichiers :

  1. Copie le dossier documentations
  2. Colle-le sur une clé USB, un NAS, un cloud perso

Résolution de problèmes courants

Problème : Le site ne se met pas à jour

Checklist de dépannage :

  1. Vérifier que le push a bien eu lieu

    • GitLab → Onglet "Dépôt" → "Commits"
    • Le dernier commit est récent ?

    • Vérifier le pipeline

    • GitLab → "Construire" → "Pipelines"

    • Le dernier pipeline est vert ✓ ?

    • Si pipeline rouge ✗

    • Clique sur le pipeline

    • Clique sur le job "pages"
    • Lis l'erreur
    • Erreur courante : Syntaxe YAML incorrecte dans mkdocs.yml
    • Solution : Corrige le fichier, sauvegarde, push

    • Vider le cache du navigateur

    • Ctrl+F5 pour forcer le rechargement

    • Ou mode navigation privée pour tester

    • Attendre

    • Parfois GitLab Pages met 5-10 minutes lors de gros changements

Problème : Le plugin Git ne push pas automatiquement

Solutions :

  1. Vérifier la configuration
    • Obsidian → Paramètres → Git
    • "Auto commit-and-sync interval" est bien à 5 minutes ?
  2. Redémarrer Obsidian
    • Ferme complètement Obsidian
    • Relance-le
  3. Push manuel
    • Palette de commandes → "Git: Commit all changes"

  4. Vérifier les credentials GitLab

    • Si le push échoue, c'est peut-être un problème d'authentification

    • Teste en ligne de commande :

      cd ~/chemin/vers/documentationsgit push

    • Si erreur, regénère un Personal Access Token sur GitLab

Problème : Erreur 404 sur une page

Cause : Le fichier n'existe pas ou le chemin est incorrect.

Solutions :

  1. Vérifie que le fichier existe

    • Dans Obsidian, navigue vers le fichier
    • Existe-t-il vraiment dans le dossier docs/ ?

    • Vérifie le nom du fichier

    • Pas d'espaces (remplace par tirets : mon-projet.md)

    • Pas de caractères spéciaux
    • Extension .md présente

    • Vérifie les liens

    • Les liens dans Markdown doivent pointer vers le bon chemin

    • Exemple : [Lien](projets-laser/mon-projet.md)

Problème : Les images ne s'affichent pas

Solutions :

  1. Vérifie le chemin de l'image

    • L'image est dans le dossier docs/ ?
    • Le chemin est correct dans le Markdown ?

    • Vérifie que l'image a bien été pushée

    • GitLab → "Dépôt" → "Fichiers"

    • Navigue vers docs/ et cherche ton image

    • Vide le cache

    • Les images sont parfois mises en cache

    • Ctrl+F5 dans le navigateur

    • Vérifie le format

    • Formats supportés : JPG, PNG, GIF, SVG, WEBP

    • Nom de fichier sans espaces ni caractères spéciaux

Commandes Git utiles (terminal)

Si tu as besoin de faire des manipulations avancées.

Vérifier l'état actuel

cd ~/chemin/vers/documentations
git status

Montre les fichiers modifiés, ajoutés, supprimés

Voir l'historique

git log --oneline -10

Montre les 10 derniers commits

Annuler les modifications locales (ATTENTION)

git checkout -- nom-du-fichier.md

Restaure un fichier à sa dernière version commitée

Récupérer depuis GitLab

git pull

Télécharge les dernières modifications depuis GitLab

Note : Le plugin Obsidian Git fait déjà un pull au démarrage, donc rarement nécessaire.

Forcer un push (si bloqué)

git push --force

⚠️ ATTENTION : N'utilise ça que si tu sais ce que tu fais. Ça écrase l'historique GitLab.

Checklist avant de partir en vacances

Pour être sûr que tout est sauvegardé :

  • [ ] Dernier commit/push fait (vérifie sur GitLab)
  • [ ] Pipeline vert ✓ (site à jour)
  • [ ] Backup local copié sur USB/NAS
  • [ ] Mot de passe GitLab/token stocké en sécurité

Résultat : Même si ton PC meurt pendant les vacances, tout est sur GitLab et récupérable.

Récupération complète (en cas de crash PC)

Si ton PC plante et que tu dois tout réinstaller :

Étape 1 : Installer les outils

# Installer Git
sudo apt install git

# Télécharger et installer Obsidian
# https://obsidian.md

Étape 2 : Récupérer le projet

# Cloner depuis GitLab
git clone https://gitlab.com/sylden73/documentations.git
cd documentations

Étape 3 : Ouvrir dans Obsidian

  1. Lance Obsidian
  2. "Open folder as vault"
  3. Sélectionne le dossier documentations

Étape 4 : Réinstaller le plugin Git

  1. Paramètres → Plugins communautaires → Activer
  2. Parcourir → Chercher "Git"
  3. Installer → Activer
  4. Configurer (auto-sync 5 min, etc.)

Résultat : Tu as TOUT récupéré. Rien n'est perdu.

Astuces d'utilisation

Raccourcis Obsidian utiles

  • Ctrl+N : Nouvelle note
  • Ctrl+O : Ouvrir une note rapidement
  • Ctrl+E : Basculer mode édition/lecture
  • Ctrl+F : Rechercher dans la note
  • Ctrl+Shift+F : Rechercher dans tout le vault
  • Ctrl+Click sur un lien : Ouvrir dans un nouvel onglet

Templates Obsidian

Tu peux créer des templates réutilisables :

  1. Crée un dossier _templates/ dans ton vault
  2. Crée _templates/projet-fab-c.md avec ton template
  3. Active le plugin "Templates" dans Obsidian
  4. Configure le dossier de templates
  5. Utilise : Palette de commandes → "Templates: Insert template"

Liens internes Obsidian

Pour lier entre tes pages :

Voir aussi [[Autre Projet]]
Voir aussi [[projets-laser/boite-laser|Boîte Laser]]

Obsidian autocomplète les noms de fichiers quand tu tapes [[

Mémo rapide : Que faire quand...

Situation Action
J'ai fini d'écrire Sauvegarde (Ctrl+S) et c'est tout
Je veux publier maintenant Push manuel (Palette → Git commit)
Le site ne se met pas à jour Vérifie pipeline GitLab
Une image ne s'affiche pas Vérifie le chemin et vide le cache
Je veux faire un backup Copie le dossier documentations
Mon PC a planté Clone depuis GitLab
Je veux prévisualiser avant publish mkdocs serve (optionnel)

Ressources et aide

  • Documentation Obsidian : https://help.obsidian.md
  • Forum Obsidian : https://forum.obsidian.md
  • Documentation MkDocs Material : https://squidfunk.github.io/mkdocs-material/
  • Documentation GitLab Pages : https://docs.gitlab.com/ee/user/project/pages/

Tu as maintenant tout ce qu'il faut pour utiliser efficacement ton système de documentation fab-c ! 🚀

Questions ? Contacte Sylvain Denis - sylvain.denis@ulb.be