update

Dockerfile

@@ -26,10 +26,10 @@ COPY app/ .
 # Conditionally convert LaTeX to MDX if ENABLE_LATEX_CONVERSION=true
 ARG ENABLE_LATEX_CONVERSION=false
 RUN if [ "$ENABLE_LATEX_CONVERSION" = "true" ]; then \
-    echo "🔄 LaTeX conversion enabled - running latex:convert..."; \
+    echo "🔄 LaTeX importer enabled - running latex:convert..."; \
     npm run latex:convert; \
     else \
-    echo "⏭️  LaTeX conversion disabled - skipping..."; \
+    echo "⏭️  LaTeX importer disabled - skipping..."; \
     fi
 
 # Ensure `public/data` is a real directory with real files (not a symlink)

README.md

@@ -1,4 +1,14 @@
-
+---
+title: 'Bringing paper to life: A modern template for scientific writing'
+emoji: 📝
+colorFrom: blue
+colorTo: indigo
+sdk: docker
+pinned: false
+header: mini
+app_port: 8080
+thumbnail: https://huggingface.co/spaces/tfrere/research-paper-template/thumb.jpg
+---
 <div align="center">
 
 # Research Article Template

app/scripts/{latex-to-mdx → latex-importer}/README.md

@@ -1,6 +1,6 @@
-# LaTeX to MDX Toolkit
+# LaTeX Importer
 
-Complete LaTeX to MDX (Markdown + JSX) conversion optimized for Astro with advanced support for references, interactive equations, and components.
+Complete LaTeX to MDX (Markdown + JSX) importer optimized for Astro with advanced support for references, interactive equations, and components.
 
 ## 🚀 Quick Start
 
@@ -16,7 +16,7 @@ node mdx-converter.mjs      # Markdown → MDX
 ## 📁 Structure
 
 ```
-latex-to-mdx/
+latex-importer/
 ├── index.mjs                    # Complete LaTeX → MDX pipeline
 ├── latex-converter.mjs          # LaTeX → Markdown with Pandoc
 ├── mdx-converter.mjs           # Markdown → MDX with Astro components

app/scripts/{notion-to-mdx → notion-importer}/README.md

@@ -1,6 +1,6 @@
-# Notion to MDX Toolkit
+# Notion Importer
 
-Complete Notion to MDX (Markdown + JSX) conversion optimized for Astro with advanced media handling, interactive components, and seamless integration.
+Complete Notion to MDX (Markdown + JSX) importer optimized for Astro with advanced media handling, interactive components, and seamless integration.
 
 ## 🚀 Quick Start
 
@@ -23,7 +23,7 @@ node mdx-converter.mjs       # Markdown → MDX
 ## 📁 Structure
 
 ```
-notion-to-mdx/
+notion-importer/
 ├── index.mjs                    # Complete Notion → MDX pipeline
 ├── notion-converter.mjs         # Notion → Markdown with notion-to-md v4
 ├── mdx-converter.mjs           # Markdown → MDX with Astro components

app/src/content/article.mdx

@@ -29,7 +29,7 @@ import Markdown from "./chapters/demo/markdown.mdx";
 import Components from "./chapters/demo/components.mdx";
 import Greetings from "./chapters/demo/greetings.mdx";
 import VibeCodingCharts from "./chapters/demo/vibe-coding-charts.mdx";
-import LatexConversion from "./chapters/demo/latex-convertion.mdx";
+import ImportContent from "./chapters/demo/import-content.mdx";
 
 <Introduction />
 
@@ -43,7 +43,7 @@ import LatexConversion from "./chapters/demo/latex-convertion.mdx";
 
 <VibeCodingCharts />
 
-<LatexConversion />
+<ImportContent />
 
 <BestPractices />
 

app/src/content/chapters/demo/import-content.mdx

@@ -0,0 +1,164 @@
+import Note from '../../../components/Note.astro';
+import Accordion from '../../../components/Accordion.astro';
+
+## Import from LaTeX or Notion
+
+<Note variant="warning">
+⚠️ **Experimental Features** — These conversion toolkits are in active development and may not work perfectly with all source documents. Results may vary depending on your content structure and complexity.
+</Note>
+
+Convert your existing content directly to this template using our built-in conversion toolkits. Two powerful systems transform different source formats into fully interactive web articles with all template features.
+
+### Available Converters
+
+**LaTeX importer** — Transform academic LaTeX papers into interactive web articles
+
+**Notion importerX** — Convert Notion pages with media and components
+
+Both systems preserve your content while adding modern web features: dark mode, responsive design, optimized figures, and live references.
+
+### LaTeX importer
+
+Perfect for academic papers, research documents, and scientific content with equations and references.
+
+#### Quick Start
+
+```bash
+# Navigate to the LaTeX importer
+cd app/scripts/latex-importer/
+
+# Place your LaTeX files in input/
+cp your-paper.tex input/main.tex
+cp your-paper.bib input/main.bib
+cp -r your-figures/ input/figures/
+
+# Run the complete conversion
+node index.mjs
+
+# Your converted article is ready!
+# → output/main.mdx (ready for the template)
+# → assets/image/ (processed figures)
+```
+
+#### What Gets Converted
+
+**Mathematical content:**
+- `\label{eq:name}` → Interactive equations with `\htmlId{name}`
+- `\ref{eq:name}` → Clickable equation links
+- Complex math preserved with KaTeX
+
+**References and citations:**
+- `\label{sec:intro}` → Invisible anchors `<span id="intro">`
+- `\ref{sec:intro}` → Working internal links
+- Bibliography integration
+
+**Visual elements:**
+- `\includegraphics{}` → `<Figure>` components with zoom
+- `\highlight{text}` → `<mark>` styling  
+- Figure captions and numbering
+
+#### Prerequisites
+
+- **Pandoc** installed (`brew install pandoc`)
+- LaTeX source files and bibliography
+- Figures in supported formats (PNG, JPG, PDF)
+
+### Notion importer
+
+Ideal for collaborative content, documentation, and pages with rich media and interactive elements.
+
+#### Quick Start
+
+```bash
+# Navigate to the Notion importer
+cd app/scripts/notion-importer/
+
+# Install dependencies
+npm install
+
+# Setup environment variables
+cp env.example .env
+# Edit .env with your Notion token
+
+# Configure pages to convert
+# Edit input/pages.json with your page IDs
+
+# Run the complete conversion
+node index.mjs
+
+# Your converted content is ready!
+# → output/*.mdx (ready for the template)
+# → output/media/ (downloaded images and files)
+```
+
+#### What Gets Converted
+
+**Media handling:**
+- Images, files, PDFs automatically downloaded
+- Smart path conversion for web accessibility
+- Figure components with zoom/download functionality
+
+**Interactive components:**
+- Callouts → Astro `Note` components
+- Enhanced tables with styled containers
+- Code blocks with copy functionality
+
+**Smart formatting:**
+- Notion internal links → relative links
+- Artifact cleanup and optimization
+- Automatic frontmatter generation
+
+#### Prerequisites
+
+- **Node.js** with ESM support
+- **Notion Integration**: Set up an integration in your Notion workspace
+- **Notion Token**: Copy the "Internal Integration Token"
+- **Shared Pages**: Share the specific Notion page(s) with your integration
+
+<Accordion title="Advanced conversion options">
+
+**LaTeX importer:**
+```bash
+# Step-by-step conversion
+node latex-converter.mjs    # LaTeX → Markdown  
+node mdx-converter.mjs      # Markdown → MDX
+
+# Bibliography only
+node index.mjs --bib-only
+
+# Clean output before conversion
+node index.mjs --clean
+```
+
+**Notion importer:**
+```bash
+# Full workflow with token
+NOTION_TOKEN=your_token node index.mjs --clean
+
+# Notion to Markdown only
+node index.mjs --notion-only
+
+# Markdown to MDX only  
+node index.mjs --mdx-only
+```
+
+<Note variant="info">
+💡 **Hugging Face Spaces** — When deploying on Hugging Face Spaces, add your `NOTION_TOKEN` to the Space secrets for secure access during the build process.
+</Note>
+
+</Accordion>
+
+### Docker Deployment
+
+When deploying on Hugging Face Spaces, you can enable automatic conversion during the build process:
+
+- **LaTeX**: Set `ENABLE_LATEX_CONVERSION=true`
+- **Notion**: Set `ENABLE_NOTION_CONVERSION=true`
+
+If these variables are configured in your Space, the build process will automatically execute the conversion, transforming your source content into the final blog post format.
+
+This allows you to maintain source files in your repository while automatically generating the MDX content for production deployment.
+
+### Result
+
+Both conversion systems produce fully interactive articles that preserve your original content while gaining all template benefits: responsive design, interactive equations, zoomable figures, and modern web features.