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