eXeConvert

Conversor estático en navegador para transformar proyectos de eXeLearning y convertir entre .elp, .elpx, .docx, .md y .pdf sin salir del navegador.

Qué hace ahora

• Lee directamente en el navegador archivos .elp, .elpx, .docx y .md.
• Convierte proyectos legacy .elp a .elpx usando el pipeline de importación/exportación de eXeLearning.
• Analiza content.xml de proyectos .elpx modernos y permite seleccionar páginas antes de exportar.
• Reconstruye una versión HTML estable del contenido para previsualización y exportación.
• Exporta .elpx a .docx, .md o .pdf.
• En CLI y paquetes nativos, la exportación .pdf usa Puppeteer con navegador embebido y MathJax en SVG para mantener fórmulas vectoriales.
• Importa .docx y .md a .elpx.

Qué no hace todavía

• No intenta reproducir toda la lógica visual de singlepage; genera una versión estable orientada a exportación y previsualización.
• La exportación a .docx genera un documento nativo simplificado, priorizando compatibilidad con LibreOffice y Word frente a la fidelidad visual absoluta.
• La conversión depende de la estructura semántica disponible en el proyecto o documento de origen; algunos iDevices, estilos complejos o comportamientos interactivos pueden degradarse a una representación más simple.

Desarrollo

npm install
npm run dev

La aplicación queda disponible en http://localhost:3007.

CLI

También hay una interfaz de línea de comandos para automatizar conversiones desde terminal o desde otros programas.

En desarrollo:

npm run cli -- archivo-entrada archivo-salida
npm run cli -- inspect archivo.elpx

Para generar la CLI distribuible:

npm run build:cli

Instalación para usuarios técnicos:

npm install -g execonvert

o sin instalar globalmente:

npx execonvert archivo-entrada archivo-salida

El comando instalado siempre es execonvert.

Distribución para usuarios normales:

• Linux Debian/Ubuntu/MX: paquete .deb
• Linux genérico: AppImage
• Windows: instalador .exe
• macOS: instalador .pkg

Esos paquetes se generan en GitHub Actions y se adjuntan a cada release de GitHub.

Ejemplos:

npm run cli -- apuntes.md apuntes.elpx --h1 resource-title --h2 subpage --h3 idevice
npm run cli -- proyecto.elpx proyecto.docx
npm run cli -- legacy.elp legacy.elpx
npm run cli -- legacy.elp legacy.pdf
npm run cli -- proyecto.elpx resumen.md --pages 1,2.1
npm run cli -- inspect proyecto.elpx --json

Opciones principales:

• inspect <archivo.elpx>: muestra la estructura de páginas.
• --json: salida pensada para scripts.
• --pages 1,2.1: exporta solo esas páginas de un .elpx.
• --page-id <id> / --page-ids a,b,c: selección por IDs internos.
• --h1, --h2, --h3, --h4: controlan cómo se interpreta la estructura al importar .docx o .md a .elpx.

Valores admitidos para la estructura de importación:

• --h1: page | resource-title
• --h2, --h3, --h4: idevice | subpage

Estado actual de la CLI:

• soportado: .md/.txt -> .elpx
• soportado: .docx -> .elpx
• soportado: .elpx -> .md
• soportado: .elpx -> .docx
• soportado: .elpx -> .pdf
• soportado: .elp -> .elpx
• soportado: .elp -> .md
• soportado: .elp -> .docx
• soportado: .elp -> .pdf

Organización del código

La web y la CLI están separadas como dos frontends distintos sobre el mismo núcleo de conversión:

• app/: entrada y configuración de la aplicación web.
• src/: lógica compartida de conversión.
• cli/: entrada y runtime específico de la CLI.
• bin/: lanzador ejecutable de la CLI.

Comprobaciones:

npm run check:web
npm run check:cli
npm run build
npm run build:cli

La separación no exige cambios en GitHub Pages. El despliegue web sigue dependiendo de vite.config.ts y del contenido generado en docs/.

Publicación en GitHub Pages

• La app compilada se genera en docs/.
• El despliegue en https://execonvert.github.io/ se hace con GitHub Actions.
• Cada push a main recompila la app y publica el contenido de docs/ como sitio de GitHub Pages.
• En local puedes seguir usando npm run build para comprobar el resultado antes de subir cambios.

Publicación de la CLI

• La CLI distribuible se compila en dist/cli/.
• El ejecutable expuesto al usuario es siempre execonvert.
• npm pack genera un paquete instalable que conserva ese comando.
• El workflow de releases puede adjuntar ese .tgz a una release de GitHub para que otros usuarios lo descarguen e instalen con:

npm install -g ./execonvert-<version>.tgz

Paquetes nativos

Además del paquete npm, el repositorio incluye workflows para generar instaladores autocontenidos:

• .deb para Debian/Ubuntu/MX Linux
• AppImage para Linux
• .exe instalador para Windows
• .pkg instalador para macOS

La base de esos paquetes está en:

• scripts/package-cli/prepare-bundle.mjs
• scripts/package-cli/build-deb.sh
• scripts/package-cli/build-appimage.sh
• scripts/package-cli/build-windows-installer.ps1
• scripts/package-cli/build-macos-pkg.sh
• .github/workflows/build-native-packages.yml

La idea es siempre la misma:

• construir la CLI
• empaquetarla con un runtime de Node incluido
• descargar Chrome for Testing dentro de runtime/puppeteer
• instalar un comando final llamado execonvert

Estadísticas de visitas

La app puede integrarse con un contador propio en IONOS:

• resumen mínimo en el pie
• carga asíncrona para no bloquear la UI
• panel privado por aplicación
• series temporales y referrers

Backend base de esta app:

• analytics/execonvert/track.php
• analytics/execonvert/admin-stats.php
• analytics/execonvert/lib.php
• analytics/execonvert/config.sample.php

Arquitectura

• src/converter.ts: parser del .elpx, selección de páginas, normalización HTML y exportación a .docx y .pdf. La ruta PDF principal en Node/CLI usa HTML imprimible + MathJax SVG + Puppeteer; pdfmake queda como fallback del navegador web.
• src/legacy-elp.ts: conversión de .elp legacy a .elpx mediante bundles de eXeLearning.
• src/docx-import.ts: importación de .docx a .elpx.
• src/markdown-import.ts y src/elpx-markdown.ts: conversiones entre .md y .elpx.
• src/main.ts: interfaz web estática.

La siguiente iteración razonable es sustituir el parser simplificado por una integración más directa con la lógica de exportación de eXeLearning.