Repolode
Enviar
Sayi

Sayi/poi-tl

Motor de plantillas para Java que genera documentos Word (.docx) a partir de plantillas con etiquetas, basado en Apache POI.

Alternativa open source a:Aspose.Words

Ver en GitHubSitio web
Estrellas
5,169
Forks
1,131
Issues abiertos
64
Último commit
hace 9 días

¿Qué es?

poi-tl (poi-template-language) genera documentos Word nuevos a partir de una plantilla .docx y un modelo de datos. Las etiquetas, como {{name}}, se reemplazan por texto, imágenes, tablas, listas o gráficos, y se conserva en el resultado el formato de la plantilla, incluidas las fuentes, los colores y la maquetación.

El motor no tiene lógica: las plantillas solo contienen etiquetas, y los bloques condicionales o los bucles sobre colecciones se gestionan mediante tipos de etiqueta. Se pueden asociar funciones personalizadas a las etiquetas mediante la interfaz de plugin RenderPolicy. Las extensiones opcionales añaden resaltado de sintaxis para código y conversión de Markdown a Word, y también se admiten expresiones SpringEL.

La biblioteca requiere JDK 1.8+ y Apache POI 5.2.2+ para las ramas actuales 1.12.x y 1.13.x.

Funciones clave

  • 01Inserta texto, imágenes, tablas, listas numeradas y gráficos en plantillas de Word.
  • 02Admite bloques condicionales y bucles foreach, incluidos los bucles por filas y columnas de tablas.
  • 03Conserva los estilos de la plantilla en los documentos generados.
  • 04Ofrece una interfaz de plugin (RenderPolicy) para aplicar lógica personalizada a cualquier etiqueta.
  • 05Admite comentarios, archivos adjuntos, marcadores, hipervínculos y subplantillas anidadas.

Casos de uso

  • Generar contratos, facturas o informes desde un backend Java a partir de una plantilla de Word.
  • Exportar documentos Word basados en datos desde una aplicación web para su descarga.
  • Crear archivos Word con tablas y gráficos dinámicos a partir de datos de la aplicación.

Inicio rápido

  1. 1

    Añade la dependencia Maven de poi-tl (versión 1.12.2) a tu proyecto

  2. 2

    Crea una plantilla de Word que contenga la etiqueta {{title}} y, después, compílala, genera el documento y escribe el resultado en Java

Antes de usarlo

  • Se requieren JDK 1.8 o posterior y Apache POI 5.2.2 o posterior; las versiones anteriores de POI provocan errores en tiempo de ejecución.

Temas

#java#word#docx#template-engine#apache-poi#document-generation#export#markdown#poi#template

Preguntas frecuentes

¿Qué es poi-tl?
Motor de plantillas para Java que genera documentos Word (.docx) a partir de plantillas con etiquetas, basado en Apache POI. poi-tl (poi-template-language) genera documentos Word nuevos a partir de una plantilla .docx y un modelo de datos. Las etiquetas, como {{name}}, se reemplazan por texto, imágenes, tablas, listas o gráficos, y se conserva en el resultado el formato de la plantilla, incluidas las fuentes, los colores y la maquetación.
¿poi-tl es gratuito? ¿Qué licencia tiene?
poi-tl es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿poi-tl sigue mantenido?
Mantenimiento activo. El último commit de poi-tl fue el 13 oct 2026.
¿Para qué puedo usar poi-tl?
Generar contratos, facturas o informes desde un backend Java a partir de una plantilla de Word. Exportar documentos Word basados en datos desde una aplicación web para su descarga. Crear archivos Word con tablas y gráficos dinámicos a partir de datos de la aplicación.
¿Cómo se instala poi-tl?
Añade la dependencia Maven de poi-tl (versión 1.12.2) a tu proyecto Crea una plantilla de Word que contenga la etiqueta {{title}} y, después, compílala, genera el documento y escribe el resultado en Java
¿Dónde consigo poi-tl?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Sayi/poi-tl

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados