El Blog de ForjaLibre

Lanzamiento de BiblioHouse v1.8: Exportación web estática y fin de los cuelgues de UI

Ya está disponible para descargar la versión 1.8 de BiblioHouse. Esta actualización se centra en resolver la deuda técnica relacionada con el rendimiento gráfico y añade una de las características más demandadas para compartir tu colección.

A continuación, detallo los cambios a nivel técnico y funcional de esta versión.

Generación de Galería Web Estática (Autocontenida)

La novedad principal es la nueva función "Exportar a Web". BiblioHouse ahora es capaz de compilar tu biblioteca en un único archivo HTML estático.

A nivel técnico, el objetivo era crear un archivo con cero dependencias externas. El resultado es un documento que integra la estructura, los estilos (CSS) y la lógica de filtrado (escrita en Vanilla JS) sin hacer peticiones a servidores de terceros ni requerir un backend.

  • Diseño: Presenta un layout en cuadrícula horizontal (estilo Netflix) que agrupa tus libros automáticamente por estanterías o géneros.

  • Buscador integrado: El JavaScript embebido permite filtrar las portadas en tiempo real directamente en el cliente (navegador).

  • Portabilidad: Al ser un archivo autocontenido, puedes alojarlo en tu propio VPS, subirlo a un hosting gratuito como GitHub Pages/Forgejo, abrirlo localmente haciendo doble clic, o incluso enviarlo por WhatsApp a tus contactos.

Refactorización del Hilo de Interfaz (JavaFX Application Thread)

En versiones anteriores, acciones como la carga masiva de portadas o la escritura del JSON en disco provocaban freezes (congelaciones) en la interfaz gráfica.

Hemos reestructurado el modelo de concurrencia de la aplicación. Ahora, las tareas de I/O (lectura/escritura de disco y red) y el procesamiento de imágenes están estrictamente segregados a hilos secundarios (Task y CompletableFuture). Esto libera al JavaFX Application Thread, garantizando que el scroll y las animaciones se mantengan fluidos independientemente del tamaño de la base de datos o de la latencia de NextCloud.

Correcciones de Interfaz y Mantenimiento

  • Modo Oscuro integral: Se han parcheado las vistas secundarias y los diálogos modales para que hereden correctamente las hojas de estilo del tema PrimerDark (AtlantaFX), solucionando los problemas de contraste y legibilidad que existían al cambiar de tema.

  • Limpieza del repositorio: Se ha configurado un archivo .gitignore estricto y se han purgado los archivos de configuración locales del IDE y metadatos de pruebas que ensuciaban el control de versiones.

  • Internacionalización (i18n): Revisión y corrección de las cadenas de texto en los distintos idiomas soportados y actualización del Manual de Usuario para reflejar los cambios en la exportación web.


⚠️ Aviso crítico de instalación

Hemos realizado cambios masivos en la arquitectura interna y en la gestión de la memoria. Si instalas esta actualización por encima de la anterior y notas un comportamiento inestable o cierres inesperados, desinstala el programa por completo y haz una instalación limpia.

Tus datos (el archivo biblioteca.json, tus portadas y tus credenciales) están alojados en tu directorio de usuario de forma independiente al programa. La desinstalación no los borrará y la nueva versión los reconocerá automáticamente al arrancar.

Código fuente y descargas: Disponibles en el repositorio oficial de Forja Libre.

Thoughts? Leave a comment