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. epy_reports sustituye a epy_mdr: es el mismo proyecto, renombrado y con desarrollo activo. 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 conforme se escribe.
• 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 habitual.

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.
• Galería de temas: una grilla que muestra cada tema como una miniatura de color y tipografía, para elegir la identidad de un vistazo antes de aplicarla.
• 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.

Bloques de diseño

• Se insertan componentes de presentación desde un selector visual con miniaturas —sin recordar sintaxis—: tarjetas, números grandes (las mismas estadísticas destacadas de las presentaciones), líneas de tiempo, agendas numeradas, texto guía e insignias.
• Aviso / divulgación insertable (submenú Disclosure en el menú Elements): cuatro tipos predefinidos —asistencia de IA, integridad del documento, confidencialidad y borrador— que insertan un bloque ::: {.disclosure} con texto editable, al estilo del tema activo.
• Toman el color y la tipografía del tema activo, de modo que un informe se ve consistente de la portada al último bloque.

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. El ejemplo de uso —la memoria de cálculo del método de Newmark— se publica también en ambos idiomas (newmark.md / newmark_es.md), y el script de renderizado genera las dos versiones; el ejemplo incluye un bloque de divulgación de uso de IA insertado con el componente Disclosure.

Por qué es confiable

• La misma render de Pandoc alimenta la vista previa y todas las exportaciones: lo que se ve en pantalla es lo que se obtiene 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 un mismo motor con sus librerías hermanas —epy_slides (presentaciones) y epy_papers (artículos científicos)—: el sistema de temas con su galería, los bloques de diseño y los dos motores de diagramas son los mismos en las tres, con las adaptaciones que amerita cada tipo de documento. Se aprende a usar una y se pasa entre las tres sin reaprender.

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): pruébelo, úselo y adáptelo.

• 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