Saltar al contenido
src / articulos / el-almacen-digital-de-la-beta-a-la-imprenta.md

El Almacén Digital: de la beta a la imprenta

Emilio Castro //

Empecé con una idea todavía borrosa: escribir algo que acercara la programación a la gente que quiere aprender y se ahoga en jerga técnica, en conceptos que nadie se detiene a explicar.

A mitad de la escritura quise saber qué pensaba quien de verdad lo iba a leer, así que abrí un programa de lectores beta. La respuesta fue buena. Uno de esos lectores me escribió para avisarme de un error en el capítulo 9. El ejemplo de ámbito calculaba el precio con IVA como precio * (1 + IVA), y Python imprime ahí 115.99999999999999 en lugar de 116.0. Él copió el ejemplo tal cual, le salió esa cola de decimales y pensó que se había equivocado al teclear.

No se había equivocado. El libro sí.

No conozco mejor argumento para abrir un libro a lectores antes de mandarlo a la imprenta.

Qué es el libro

El Almacén Digital enseña a programar con Python desde cero, en español, y sostiene una sola metáfora de principio a fin: un almacén donde entran datos, se automatizan procesos y los sistemas tienen que aguantar el turno completo. Las variables son cajas etiquetadas y las listas, estantes. Las funciones son maquinaria que alguien tiene que poder arreglar.

La edición web es gratuita y está completa, sin capítulos reservados ni un muro a la mitad que te empuje hacia la de pago.

Para qué sirvió la beta

La primera edición beta salió el 11 de julio de 2026. La lista se cerró el 14 de septiembre y los comentarios se recibieron dos semanas más, hasta el 30.

De ahí salieron dieciséis correcciones al contenido. Cada una aparece con su capítulo y su ejercicio en las notas de versión del libro, por si alguien quiere contarlas.

Algunas eran de las que te dejan pensando. El capítulo 7 enseñaba que match compara tipo y valor. En realidad compara por igualdad, y la diferencia se nota en cuanto escribes 1.0 y lo ves encajar en un case 1:. El capítulo 11 prometía que guardar en JSON y volver a leer no pierde nada. Casi nada: una tupla regresa convertida en lista. Y el Ejercicio 3.5 mandaba investigar cómo funciona input(), que es una manera elegante de mandarte a buscar fuera lo que el libro no te había explicado dentro.

Desde la v1.11.0, los agradecimientos acreditan por su nombre a un lector, el primero en aparecer ahí.

Lo que el papel rompió

La revisión técnica más dura que tuvo este libro vino del formato impreso.

Trece esquemas pasaron meses viéndose perfectos en pantalla. Medida sobre el archivo ya compuesto para imprenta, su letra quedaba entre 4 y 6 puntos, muy por debajo del mínimo que respeta el resto del libro. Se redibujaron como vectores, y ahora el texto más pequeño de cualquier esquema mide 8.3 puntos.

El resaltado de código fue peor, porque falla callado. En pantalla, el color separa las palabras clave de las cadenas y de los comentarios, y esa separación hace la mitad del trabajo de leer. En blanco y negro, esos colores se aplanan a grises casi idénticos y el bloque entero se vuelve una mancha pareja. La edición impresa lleva su propio esquema, trazado para tinta negra.

Luego estaban los saltos de página. Siete bloques de código quedaban partidos entre dos hojas. Otros cuatro cabían enteros de sobra. El peor cortaba una función justo después de su if, y el return abría la hoja siguiente huérfano, sin la condición que lo gobierna a la vista. Un principiante que lea eso aprende mal la indentación justo en el punto donde Python no perdona.

Quedaba una cuarta falla, más barata y más incómoda: el ePub y el PDF le hablaban al lector de botones para ejecutar código que en esas ediciones no existen.

Las cuatro tienen el mismo origen. Cada una era cierta en una edición y falsa en otra. Un libro con cuatro formatos tiene cuatro verdades que hay que escribir por separado, y hasta que lo compones en papel no descubres cuántas habías dado por buenas.

El peso

Comparando archivo contra archivo, el ePub bajó de 34 MB a 4.3 y el PDF de 29 a 5.4.

Ninguno de los dos cambios tiene nada de elegante. Las figuras se rehicieron a la resolución a la que el libro de verdad las muestra, en vez de arrastrar la que traían de origen. Las fuentes incrustadas se recortaron a los caracteres que el libro usa, que son bastantes menos de los que trae una fuente completa. Es subsetting de fuentes, lo mismo que hace cualquier sitio web decente, aplicado a un ePub.

Este blog hizo la misma operación hace unas semanas, por su cuenta y por otro motivo. Las fuentes dejaron de venir de Google Fonts y ahora se sirven desde aquí, solo con los pesos y subconjuntos que usan las páginas. Al libro lo empujó el peso, y al sitio, la privacidad.

Debajo de todo esto hay una base D1 de Cloudflare, un bucket privado donde viven los archivos y una Function que valida un token antes de entregar nada. El sitio sigue siendo estático, sin servidor que mantener. Eso merece su propio post, y va a tenerlo.

Dónde conseguirlo

Las cuatro ediciones salieron el mismo día, el 15 de octubre: Kindle en Amazon, compra directa en Ko-fi, Apple Books y el impreso de 6 x 9 pulgadas. Todas están, con sus fechas, en la página de El Almacén Digital.

La edición web sigue gratuita y completa en elalmacendigital.com.mx, y así se va a quedar.

Si leíste la beta

Tu enlace de siempre funciona y ya entrega la v1.12.0, los mismos archivos que recibe alguien que compre hoy. No tienes que pagar nada ni pedirme otro enlace. Lo construí así a propósito, y desmontarlo me costaría más que mantenerlo, así que tu copia va a seguir recibiendo las ediciones que vengan.

Dieciséis de las correcciones de este libro existen porque alguien se tomó la molestia de escribirme. Gracias.