epy_papers — del manuscrito al borrador listo para enviar

epy_papers es el editor de artículos científicos que desarrollamos y usamos en ANM Ingeniería: una aplicación de escritorio para escribir un paper una sola vez y exportar un borrador listo para enviar, formateado según las guías de autor de la revista que se elija. Es libre y de código abierto (licencia MIT), con instaladores para Windows y Ubuntu, y es la librería hermana de epy_reports (informes) y epy_slides (presentaciones) dentro de la suite ePy.

La premisa: escribir en texto plano —rápido, limpio, sin pelear con el formato— y dejar que la herramienta arme el borrador conforme a lo que pide cada revista, para que el esfuerzo se concentre en la ciencia y no en la mecánica del envío.

El editor

• Vista previa en vivo lado a lado, renderizada por el mismo Pandoc que usa la exportación, y que se actualiza conforme se escribe.
• Editor multipestaña para trabajar varios manuscritos a la vez.
• Markdown con la sintaxis estándar habitual: encabezados, énfasis, listas, enlaces, imágenes y tablas.

Revistas y formato

• Cincuenta perfiles de revista (familias ASCE, Elsevier, Springer y más).
• Al elegir la revista, la vista previa se reformatea para parecerse al manuscrito que esa revista recibiría: una o dos columnas, interlineado, fuente, tamaño y tamaño de página.
• Título y resumen bilingües, palabras clave, aspectos destacados y declaraciones (CRediT, conflicto de interés, financiamiento, disponibilidad de datos).
• Ocultamiento de autoría automático para envíos a doble ciego.
• Validación del manuscrito contra los requisitos de la revista (faltantes, longitud del resumen, estilo de cita), que avisa antes de exportar.

Citas y numeración de líneas

• Citas bibliográficas con catorce estilos CSL: IEEE, APA, ASCE, Vancouver, Elsevier, Springer, Nature, Science, Chicago y más. Las citas y la lista de referencias se resuelven en la vista previa, no como marcadores.
• Numeración de líneas continua cuando la revista la solicita. Un punto importante y honesto: en la vista previa el número de línea es aproximado (el HTML ajusta los renglones distinto a Word o LaTeX); los números exactos están en el archivo exportado, que es el que cuenta para el envío. Un aviso en el preview lo deja claro.

Contenido y bloques de diseño

• Ecuaciones LaTeX renderizadas con MathJax.
• Tablas y figuras con leyenda y referencias cruzadas que se numeran y enlazan solas.
• Galería de temas y bloques de diseño (tarjetas, números grandes, líneas de tiempo, agendas) desde un selector visual con miniaturas: los mismos de epy_reports y epy_slides, con la misma estética, para una figura compuesta o un resumen visual.
• Aviso / divulgación insertable (submenú Disclosure en el menú Paper): 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.

Exportación

• Word (.docx) con una plantilla de referencia por revista.
• Fuente LaTeX con la clase de la revista (elsarticle, IEEEtran, ascelike).
• HTML autónomo que funciona offline.
• PDF si hay un motor LaTeX instalado (el .docx y la fuente .tex se generan siempre, sin dependencias externas).

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. El ejemplo de uso —el artículo sobre los tirantes del Puente de Brooklyn— se publica también en ambos idiomas (brooklyn_bridge.md / brooklyn_bridge_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.

Qué es —y qué no es

epy_papers prepara un borrador conforme a las guías de autor: formato, interlineado, numeración de líneas, estilo de cita y declaraciones, listos para subir al portal de la revista. No es el sistema de composición de la editorial: el maquetado final de la versión publicada lo hace la revista en producción. La vista previa es una aproximación fiel del manuscrito que se va a enviar, no de la versión ya diagramada. Tenerlo claro evita sorpresas.

El valor está en la conversación

Un borrador prolijo es apenas el punto de partida. El valor real de un paper se forja con la retroalimentación de otros investigadores y revisores: una crítica constructiva afina el argumento, descubre vacíos y eleva el trabajo. epy_papers existe para bajar la fricción de escribir y enviar, precisamente para que ese esfuerzo se concentre en la ciencia y en esa conversación.

Y lo mismo vale para la herramienta: al ser de código abierto, la retroalimentación constructiva de la comunidad —qué revista falta, qué requisito no se contempló, qué se puede mejorar— es muy bienvenida y ayuda a hacerla mejor.

Por qué es confiable

• La misma render de Pandoc alimenta la vista previa y la exportación: lo que se ve es, dentro de lo razonable, lo que se envía.
• Comportamiento determinista y reproducible, respaldado por una suite de pruebas automatizadas.

Parte de la suite ePy

epy_papers comparte un mismo motor con epy_reports y epy_slides: el sistema de temas con su galería, los bloques de diseño y la estética 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 para preparar y enviar artículos. Es libre y de código abierto (licencia MIT): pruébelo, úselo, adáptelo —y si usted investiga, su retroalimentación constructiva es bienvenida.

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

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