🚀 Instalación de PreTeXt con Docker según los creadores de PreTeXt

Los desarrolladores de PreTeXt ofrecen varias formas de trabajar con esta poderosa herramienta de edición de libros y documentos. Una de las más prácticas es el uso de Docker, que permite tener en tu computadora un entorno idéntico al de GitHub Codespaces, pero sin depender de la nube.

Este método es multiplataforma (funciona en Windows, macOS y Linux) y se recomienda para quienes desean un entorno local completo.

📌 Requisitos previos

• Espacio en disco: alrededor de 15 GB, ya que se instalarán herramientas como LaTeX y SageMath (incluso si ya las tienes).
• Conexión a internet: para descargar el contenedor inicial.

🛠️ Pasos de instalación

1. Descargar e instalar Visual Studio Code (VS Code)

   • Es el editor recomendado por los creadores de PreTeXt.
   • Además de servir para este entorno, es excelente para cualquier proyecto de texto o programación.

2. Descargar e instalar Docker Desktop

   • Disponible para Windows, macOS y Linux.
   • Una vez instalado, inicia Docker Desktop y acepta los términos de licencia.
   • No es necesario crear una cuenta.

3. Obtener el paquete de PreTeXt Codespace (zip)

   • Descarga el archivo comprimido PreTeXt Codespace y extráelo en un directorio de tu preferencia.
   • Ese directorio será la raíz de tu proyecto.

4. Abrir el proyecto en VS Code

   • En VS Code, ve al menú Archivo → Abrir directorio....
   • Selecciona el directorio donde extrajiste el zip y pulsa Abrir.

5. Configurar el entorno con contenedores de desarrollo (Dev Containers)

   • Es posible que aparezca un aviso emergente en VS Code preguntando si deseas instalar la extensión Dev Containers y reabrir el proyecto en un contenedor.
   • Acepta ambas opciones.
   • Si no aparece, instala manualmente la extensión Dev Containers desde el Marketplace de VS Code y luego ejecuta el comando:

     Ctrl + Shift + P → Dev Containers: Reopen in Container
     

6. Esperar la descarga inicial del contenedor

   • El primer inicio tardará varios minutos, ya que debe descargar la imagen completa.
   • En ejecuciones posteriores, será mucho más rápido.

7. 🎯 Crea o copia un proyecto a el directorio raiz

Una vez completados los pasos anteriores:

• Podrás crear, compilar y visualizar proyectos en PreTeXt directamente desde tu computadora.
• El entorno será el mismo que el de GitHub Codespaces, pero funcionando en local.
• Solo deberás recordar que cada vez que trabajes en tu proyecto, debes abrirlo dentro del contenedor de Docker.

📌 Tamaño de la instalación resultante

• La imagen principal ocupa alrededor de 11 GB.
• Los contenedores activos pueden añadir varios cientos de MB.
• El uso de volúmenes locales suma espacio adicional.
• Aun cuando el contenedor se detenga, la imagen seguirá ocupando gran parte del almacenamiento.

✅ Recomendación

Los desarrolladores de PreTeXt sugieren:

• Asegurarse de tener al menos 5–15 GB de espacio libre antes de la instalación.
• Usar el comando docker system prune de manera periódica para limpiar imágenes y contenedores no utilizados.
• Recordar que este tamaño es normal, ya que el entorno en Docker es idéntico al de GitHub Codespaces y contiene todas las dependencias necesarias.

⚠️ Conclusión:
La instalación en Docker de PreTeXt no es ligera, pero garantiza un entorno completo, consistente y multiplataforma para editar libros profesionales.

📖 Referencia

PreTeXt Guide: Installing PreTeXt — Section 2.3, “Option 1: Installing a Docker container”.
Disponible en: https://pretextbook.org/doc/guide/html/tutorial-install.html

✨ Con esta instalación, cualquier escritor o estudiante podrá transformar sus manuscritos en libros de calidad profesional, listos para distribución electrónica o impresión bajo demanda, todo con la potencia de PreTeXt y la comodidad de Docker.