README-latex-integration.md

📚 LaTeX to MDX Integration

This space allows the automatic conversion of any latex content to MDX for Astro, with real time monitoring!

🚀 Usage

📁 LaTeX Structure to follow

Place your LaTeX sources as such :

app/scripts/latex-to-mdx/input/
├── main.tex              # Main doc
├── main.bib              # Bibliography  
├── sections/             # Sections or chapters
│   ├── 01_introduction.tex
│   ├── 02_methods.tex
│   └── ...
├── figures/              # Images
└── ...                   # Other LaTeX files

Now you can start the development server!

Development mode with LaTeX Watch

npm run dev:with-latex

This commands :

1. ✅ Converts LaTeX → MDX
2. 🔄 Monitors the contents of scripts/latex-to-mdx/input/ for any change
3. 🌐 Launches an Astro server on http://localhost:4321
4. 📝 Regerenates article.mdx automatically when you do changes to the latex files!

Production Mode

npm run build

Other individual scripts

# Converts LaTeX → MDX once
npm run latex:convert

# Monitors the LaTeX repo only
npm run latex:watch

# Runs Astro without looking on latex (to edit the markdown files directly for example)
npm run dev

⚙️ Features

• 🔄 Automated conversion : 2 seconds per conversion
• 📊 Monitoring : Of everything in input/
• 🌐 Hot reload : Astro reloads after each conversion
• 📝 Colored logs : To differenciate LaTeX/Astro

🐳 Docker

Everything runs in a Dockerfile, which includes the automatic installation of pandox, the conversion of Latex to MDX before the build, and supports the latex env!

🛠️ Debugging

If the conversion fails:

1. Check the LaTeX logs (blue ones)
2. Check if Pandoc is installed properly
3. Check the manual conversion with npm run latex:convert