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