epy_reports — del texto plano al informe de ingeniería

epy_reports es el editor de documentos que desarrollamos y usamos en ANM Ingeniería: una aplicación de escritorio para escribir desde una nota técnica rápida hasta un informe de ingeniería completo, en Markdown/Quarto, con vista previa en vivo y exportación a PDF, HTML y Word de un clic. Es libre y de código abierto (licencia MIT), con instaladores para Windows y Ubuntu. Y es, además, la cara editable del motor de documentación de la suite ePy (epy_docs): lo que la suite arma de forma programática, en epy_reports se redacta y se ajusta a mano.

La premisa es simple: escribir en texto plano —rápido, limpio, sin pelear con el formato— y obtener un documento con la presentación de un informe profesional.

El editor

• Vista previa en vivo lado a lado, renderizada por Pandoc, que se actualiza mientras escribís.
• Editor multipestaña para trabajar varios documentos a la vez.
• Markdown y Quarto (.qmd): encabezados, énfasis, listas, enlaces e imágenes, con la sintaxis estándar que ya conocés.

Apariencia e identidad visual

• Nueve temas listos y un editor de temas para crear una identidad propia: colores, fuentes, escala tipográfica h1-h6 y colores de los llamados, con vista previa en vivo. Lo demás (paleta de la interfaz, resaltado de sintaxis, contraste) se deriva solo. Los temas se guardan y se reutilizan.
• Portada dedicada con logo, encabezado corrido de hasta seis celdas y pie de página con “Página X de Y”.
• Marca de agua: cualquier imagen se convierte a escala de grises y se coloca tenue detrás de cada página.
• Plantillas de estilo que capturan tema, encabezado, pie, portada y logo para reaplicar una identidad a cualquier documento.
• Tamaño de página Carta, A4 u Oficio, con márgenes ajustables.

Índices y numeración

• Tabla de contenidos, lista de figuras, de tablas y de ecuaciones, con números de página reales (exportación a dos pasadas).
• Saltos de sección con numeración romana (i, ii, iii) para el material preliminar y arábiga (1, 2, 3) para el cuerpo.
• Referencias cruzadas estilo Quarto (@fig-, @tbl-, @eq-, @sec-) que se numeran y enlazan solas, sin necesidad de instalar Quarto.
• Citas bibliográficas BibTeX con estilos IEEE, APA o Chicago.

Contenido técnico

• Ecuaciones LaTeX renderizadas con MathJax.
• Tablas y figuras con leyenda numerada.
• Cinco tipos de llamados: nota, sugerencia, advertencia, importante y precaución.
• Notas al pie reales, ubicadas al pie de la página donde se citan (vía Paged.js).
• Listas de tareas interactivas en HTML y bloques de código con resaltado de sintaxis.
• Bloques de dos y tres columnas para disposiciones lado a lado.
• Diagramas Mermaid y nomnoml, coordinados con el color del tema.

Exportación

• PDF paginado con Paged.js: notas al pie de su página, fondo del tema a sangre, márgenes tintados al color del tema y metadatos embebidos (título, autor, derechos de autor).
• HTML autónomo que funciona offline.
• Word (.docx) con una plantilla por tema.

En dos idiomas

La interfaz se conmuta entre español e inglés en vivo, y el manual de usuario viene incluido en ambos idiomas, con capturas en el idioma correspondiente.

Por qué es confiable

• La misma render de Pandoc alimenta la vista previa y todas las exportaciones: lo que ves en pantalla es lo que obtenés en el archivo.
• Comportamiento determinista y reproducible, respaldado por una suite de pruebas automatizadas.
• El estampado del PDF usa pypdf, reportlab y Pillow: sin dependencias AGPL, apto para uso comercial.

Parte de la suite ePy

epy_reports es la cara editable de epy_docs, el motor de documentación de la suite: los reportes que las librerías de cálculo generan de forma programática se redactan y ajustan acá. Comparte el sistema de temas y los dos motores de diagramas con su librería hermana, epy_slides.

Cómo lo usamos en ANM

En ANM Ingeniería lo usamos a diario para memorias de cálculo, informes y papers. Es libre y de código abierto (licencia MIT): probalo, usalo y adaptalo.

• Descarga (todas las plataformas): https://github.com/estructuraPy/epy_reports/releases/latest
• Código fuente: https://github.com/estructuraPy/epy_reports
• Para conocer nuestros servicios de ingeniería: https://www.anmingenieria.com

— Ing. Angel Navarro-Mora M.Sc., ANM Ingeniería