🐳 Versión ligera y extendida

Este tutorial explica cómo encapsular (crear una imagen) PreTeXt en Docker de dos formas:

• Versión ligera → rápida y pequeña, para trabajar con HTML/EPUB.
• Versión extendida → más pesada, pero permite generar PDF de alta calidad con LaTeX.

📦 Imágenes disponibles

⚙️ Construcción de imágenes

🔹 Versión ligera (HTML/EPUB/Kindle/Braille)

docker build -t pretext-es-web -f Dockerfile.web .

Ejecutar:

docker run -it --rm -v $(pwd):/workspace pretext-es-web /bin/bash

🔹 Versión extendida (PDF con LaTeX)

docker build -t pretext-es-pdf -f Dockerfile.pdf .

Ejecutar:

docker run -it --rm -v $(pwd):/workspace pretext-es-pdf /bin/bash

📂 Estructura del proyecto

Tu repositorio debe tener esta estructura mínima:

📂 Libro_Generico_PreText/
│── Dockerfile.web
│── Dockerfile.pdf
│── project.ptx
│── source/
│── assets/
│── (otros_necesarios)/
│     └── es-ES.xml

👉 El archivo es-ES.xml se copia automáticamente al contenedor desde el repositorio del autor en GitHub para habilitar la localización adaptada al castellano nuestro.

🛠️ Comandos básicos dentro del contenedor

Una vez dentro del contenedor (/bin/bash), puedes usar:

pretext build web       # Construir versión web
pretext view web        # Ver en el navegador
pretext build epub      # Generar EPUB
pretext build kindle    # Generar Kindle
pretext build pdf       # Generar PDF (solo versión extendida con LaTeX)
pretext deploy          # Publicar en GitHub Pages (si está configurado)

📌 Notas

• La versión ligera es más rápida de instalar y útil para la mayoría de escritores que solo quieren HTML/EPUB.
• La versión extendida tarda más en instalarse porque descarga todo TeX Live, pero permite generar PDF de alta calidad.
• Puedes tener ambas imágenes instaladas en paralelo (pretext-es-web y pretext-es-pdf).

🎓 Recomendación para estudiantes

1. Empieza con la versión ligera (pretext-es-web).
2. Si necesitas PDF profesional, instala la versión extendida (`pretext-es-pdf).

🗂️ Diagrama de decisión

flowchart TD
    A[¿Necesitas PDF con LaTeX?] -->|No| B[Usa pretext-es (ligera)]
    A -->|Sí| C[Usa pretext-es-latex (extendida)]

✅ Con esto, tienes tu entorno de PreTeXt encapsulado en Docker, listo para usarse tanto en HTML como en PDF según tus necesidades.