# 📚 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

```bash
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

```bash
npm run build
```

### Other individual scripts

```bash
# 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`