Aperçu local pour les auteurs de contenu

Prévisualisez votre documentation localement avant de pousser vos modifications. Tout ce dont vous avez besoin est Docker et un répertoire docs/.

Prérequis

Docker Desktop installé et en cours d’exécution
Votre dépôt de contenu cloné localement avec un répertoire docs/ contenant au minimum index.mdx

Démarrer le serveur de développement

Depuis la racine de votre dépôt de contenu, exécutez :

docker run --rm -it \
  -v "$(pwd)/docs:/content/docs" \
  -p 4321:4321 \
  -e MODE=dev \
  ghcr.io/f5-sales-demo/docs-builder:latest

Ouvrez http://localhost:4321 une fois le serveur démarré.

Images et ressources statiques

Placez les images dans un sous-répertoire comme docs/images/. Le conteneur les détecte automatiquement — aucun montage de volume supplémentaire n’est nécessaire.

Référencez-les dans votre MDX avec un chemin absolu depuis la racine :

![Architecture diagram](/images/architecture.png)

Dépannage

Port déjà utilisé — Mappez vers un port hôte différent : -p 8080:4321, puis ouvrez http://localhost:8080.

Le contenu n’apparaît pas — Vérifiez que docs/index.mdx existe. Consultez la sortie du conteneur pour un message ERROR: No content found.

Image obsolète — Récupérez la dernière version :

docker pull ghcr.io/f5-sales-demo/docs-builder:latest

Pour aller plus loin

Build Docker — Détails de l’image, variables d’environnement et builds de production
Architecture — Modèle d’injection de contenu et conception du système de thème