Módulo 5: Tecnología en MetaLibros on MetaLibros

Módulo 5 · El ecosistema de publicación de MetaLibros

Mon, 01 Jan 0001 00:00:00 +0000

🧩 Módulo 5: El ecosistema de publicación de MetaLibros: PreTeXt

Este módulo introduce el uso práctico y conceptual de PreTeXt, un sistema de autoría y publicación libre basado en XML, capaz de generar libros y documentos académicos de calidad profesional en múltiples formatos (PDF, web, EPUB, Jupyter, entre otros).

🎯 Objetivos del módulo

Comprender la filosofía de PreTeXt como lenguaje de marcado estructurado.
Aprender a crear, editar y compilar proyectos en PreTeXt desde distintos entornos (local, Docker, WSL o Linux).
Entender la semántica editorial y su diferencia frente al formato visual.
Conocer el flujo completo de producción: desde el archivo fuente hasta la publicación web o impresa.
Experimentar con los contenedores Docker de PreTeXt y su integración con VS Code.

🧱 Contenidos temáticos

Contenido con semántica — Comprender el valor del significado frente a la forma visual.
Tecnologías en MetaLibros — Relación entre WSL2, Docker, VS Code y la publicación estructurada.
¿Qué es PreTeXt? — Conceptos, filosofía y ventajas del lenguaje XML.
Conexión a PreTeXt: SSH Laptop ↔ Desktop - Guía: VS en laptop conectada a una desktop, por SSH, con Ubuntu WSL y PreTeXt
PreTeXt en Docker — Construcción de imágenes y ejecución de contenedores.
PreTeXt por PreTeXt — Guía de instalación según los desarrolladores oficiales.
PreTeXt por mí — Configuración personalizada y adaptación práctica del entorno.

⚙️ Dinámica de trabajo

Cada participante avanzará a través de lecturas guiadas (los archivos del módulo) y prácticas aplicadas, organizadas en tres fases:

¿Qué es PreTeXt?

Mon, 01 Jan 0001 00:00:00 +0000

📚 PreTeXt

PreTeXt es un sistema de autoría y publicación diseñado especialmente para libros de texto, artículos de investigación y monografías en disciplinas STEM (castellano: Ciencia, Tecnología, Ingeniería y Matemáticas). Su desarrollo combina lo mejor de DocBook, LaTeX y HTML, ofreciendo salidas en múltiples formatos como impresión, PDF, web, EPUB, Jupyter Notebooks o incluso braille, con un único archivo fuente estructurado en XML. Antes de junio de 2017 se conocía como MathBook XML, por lo que muchas referencias todavía usan ese nombre.

Contenido con semántica

Mon, 01 Jan 0001 00:00:00 +0000

🧠 Estructurar el contenido con semántica

Las herramientas digitales como PreTeXt, Markdown o LaTeX no se limitan a embellecer un texto:

Permiten estructurarlo con semántica, es decir, con un significado preciso que describe la función de cada parte del documento.
En lugar de enfocarse en cómo se ve el texto, el autor se concentra en qué representa.
El resultado es un documento inteligible tanto para las personas como para las máquinas, preparado para múltiples formatos y contextos.

Tecnologías en MetaLibros

Mon, 01 Jan 0001 00:00:00 +0000

⚙️ Tecnologías en MetaLibros

El proyecto MetaLibros se sustenta en una infraestructura técnica que, en entornos Windows 10 u 11, exige la presencia de WSL2 (Windows Subsystem for Linux), alrededor de 15 GB de espacio libre en disco y la integración de varias capas de software: Visual Studio Code como entorno de desarrollo, SSH como protocólo de comunicación seguro y el programa PreTeXt, coordinada con WSL2 para garantizar portabilidad y reproducibilidad; Docker puedo incorporarse como plataforma -alternativa- de contenedores para instalaciones personalizadas de PreTeXt.

Conexión a PreTeXt: Cliente VS ↔ Servidor con PreTexT

Mon, 01 Jan 0001 00:00:00 +0000

🔧 Uso de una computadora (Cliente) conectada a otra (Servidor); con WSL y PreTeXt

Esta guía explica cómo configurar una conexión segura mediante SSH entre un Cliente usando Visual Studio Code (VS Code), y un Servidor con Windows 11 y Ubuntu WSL2, para editar y compilar proyectos PreTeXt desde el Cliente. Incluye la configuración de un entorno virtual Python en WSL llamado editorial, donde está instalado PreTeXt, asegurando que el sistema permanezca ordenado y reproducible.

PreTeXt en Docker

Mon, 01 Jan 0001 00:00:00 +0000

🐳 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

Imagen	Peso aprox.	Soporte formatos	¿Cuándo usarla?
pretext-es-web	🚀 Ligera (3–4 GB)	✅HTML, ✅EPUB, ✅Kindle, ✅Braille,✅PDF (texlive)	Si solo necesitas publicar en web o eBook y PDF en prosa.
pretext-es-pdf	📚 Pesada (10-15 GB)	✅Todo lo anterior + ✅PDF (texlive completo)	Si necesitas generar PDFs con contenido matemáticos, gráficos o profesionales desde PreTeXt.

⚙️ Construcción de imágenes

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

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

Ejecutar:

PreTeXt con Docker según PreTeXt

Mon, 01 Jan 0001 00:00:00 +0000

🚀 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.

PreTeXt en Docker: Construcción y Ejecución

Mon, 01 Jan 0001 00:00:00 +0000

🐳 PreTeXt en Docker: Construcción y Ejecución

Este documento resume cómo construir una imagen Docker con PreTeXt, ejecutar un contenedor, y servir un libro en formato web.

El objetivo es que cualquier escritor o creador pueda trabajar en su proyecto sin complicaciones técnicas.

🐋 1. Construcción de la imagen Docker

Para generar una imagen de PreTeXt, cree un archivo llamado Dockerfile con este contenido:

# Imagen base con Python 3.11
FROM python:3.11-slim

# Instalar dependencias del sistema necesarias
RUN apt-get update && apt-get install -y \
 git \
 make \
 texlive-full \
 latexmk \
 && rm -rf /var/lib/apt/lists/*

# Instalar PreTeXt CLI
RUN pip install --no-cache-dir pretext

# Crear usuario de trabajo
WORKDIR /workspace

# Montar volúmenes al iniciar
VOLUME ["/workspace"]

# Comando por defecto
CMD ["bash"]

Ahora, en la terminal construye la imagen: