README-latex-integration.md

📚 LaTeX to MDX Integration

Cette intégration permet de convertir automatiquement des sources LaTeX en MDX pour Astro, avec surveillance en temps réel des changements.

🚀 Utilisation

Mode Développement avec LaTeX Watch

# Démarre le serveur de développement avec surveillance LaTeX
npm run dev:with-latex

Cette commande :

1. ✅ Convertit initialement LaTeX → MDX
2. 🔄 Surveille scripts/latex-to-mdx/input/ pour les changements
3. 🌐 Lance le serveur Astro sur http://localhost:4321
4. 📝 Régénère automatiquement article.mdx lors de modifications

Mode Production

# Build de production (convertit LaTeX puis build Astro)
npm run build

Scripts Individuels

# Conversion unique LaTeX → MDX
npm run latex:convert

# Surveillance LaTeX uniquement
npm run latex:watch

# Développement Astro classique (sans LaTeX)
npm run dev

📁 Structure LaTeX

Place tes sources LaTeX dans :

app/scripts/latex-to-mdx/input/
├── main.tex              # Document principal
├── main.bib              # Bibliographie  
├── sections/             # Chapitres/sections
│   ├── 01_introduction.tex
│   ├── 02_methods.tex
│   └── ...
├── figures/              # Images
└── ...                   # Autres fichiers LaTeX

⚙️ Fonctionnalités

• 🔄 Conversion automatique : 2 secondes par conversion
• 📊 Surveillance complète : Tout le dossier input/
• 🎯 Intégration Docker : Pandoc installé automatiquement
• 🌐 Hot reload : Astro recharge automatiquement après conversion
• 📝 Logs colorés : Différenciation LaTeX/Astro dans la console

🐳 Docker

Le Dockerfile inclut maintenant :

• Installation automatique de Pandoc
• Conversion LaTeX → MDX avant le build Astro
• Support complet de l'environnement LaTeX

🛠️ Debugging

Si la conversion échoue :

1. Vérifier les logs LaTeX (en bleu)
2. Vérifier que Pandoc est installé
3. Tester la conversion manuelle : npm run latex:convert