Kodex: recuperar un espacio para escribir
Tabla de contenidos
Kodex es el proyecto que da forma a Kazztor.net, una publicación personal para compartir conocimientos, ideas y experiencias. Su propósito es ofrecer un lugar donde el contenido tenga espacio para desarrollarse, con una presentación que cuide la legibilidad, la tipografía y el ritmo de lectura. La profundidad importa; la extensión depende de lo que cada texto necesite.
Un proyecto que quedó en pausa
Durante sus primeras etapas, el sitio sirvió para explorar la experiencia de lectura. Los artículos eran textos de prueba utilizados para observar tamaños de letra, espaciado y composición. No constituían una colección editorial lista para publicarse.
Después de varios meses sin mantenimiento, el repositorio conservaba decisiones de distintas etapas: configuraciones de despliegue anteriores, dependencias pendientes de revisar y funciones que no estaban completamente conectadas. Retomarlo exigía comprender qué había antes de seguir agregando cosas.
Recuperar primero la dirección
La recuperación comenzó con una auditoría de lectura. Se revisaron Git, la arquitectura, las dependencias y los sistemas de temas, idiomas, imágenes, búsqueda y navegación. Esa revisión permitió separar el comportamiento comprobado de las intenciones que sólo existían en la documentación.
Con Repositorio DEV 0.3 como guía, el siguiente trabajo fue definir el producto. Se confirmó Kazztor.net como dominio, español como idioma base e inglés como segundo idioma. También se decidió mantener una publicación estática, con el contenido junto al código y Hetzner como destino de despliegue mediante Nginx. Capacidades como el newsletter quedaron fuera del alcance actual.
Construir una base coherente
La recuperación técnica avanzó por incrementos: un entorno con Node.js 24 y npm 11, Astro 7 y un modelo editorial bilingüe. Cada traducción tiene su propia ruta y se relaciona con la otra mediante una clave explícita. Markdown es el formato habitual; MDX queda disponible para composiciones que necesitan componentes.
La presentación adoptó style-foundation v0.2.0 y los temas claro, oscuro y de sistema. La navegación editorial, las categorías, RSS y los metadatos se ajustaron al idioma activo. Pagefind conectó la búsqueda con los artículos publicados, mientras las pruebas automatizadas comenzaron a cubrir tanto contenido representativo como colecciones vacías.
El trabajo más reciente se concentró en imágenes locales responsivas, textos alternativos, dimensiones reservadas y tablas y bloques de código que puedan leerse en pantallas pequeñas. También se comprobó que el contenido esencial permanezca accesible sin JavaScript.
Volver a escribir
La recuperación busca reducir el trabajo necesario para publicar y mantener el sitio. Todavía quedan la revisión del texto legal y la comprobación del despliegue y su procedimiento de rollback en la infraestructura real.
Este artículo marca el regreso al contenido propio. La base técnica existe para acompañar ese trabajo: escribir, revisar, traducir y compartir textos que aporten algo a quien los lea.
Categoría: Desarrollo
Etiquetas: kodexastro