fix(overleaf): compatibilidad con LuaLaTeX en Overleaf y bump a 2.2.2 (#35)

Overleaf ignora la línea mágica '% !TeX program = lualatex' y elige el motor desde Menu -> Compiler, con prioridad sobre $pdf_mode del .latexmkrc, por lo que los proyectos importados compilaban con XeLaTeX/pdfLaTeX y fallaban con 'TeX capacity exceeded' (memoria fija de esos motores).

- .latexmkrc: $pdflatex, $xelatex y $latex redirigidos a LuaLaTeX. Verificado simulando la invocación de Overleaf (latexmk -pdfxe): exit 0 y PDF completo. En compilación normal (pdf_mode = 4) estas variables no se usan.
- cls/eps-metadata.tex y cls/eps-tfg.cls: comprobación de motor con mensaje explicativo en lugar del error críptico de memoria.
- docs/OVERLEAF.md: guía nueva (compilador, TeX Live, minted, límites de compilación, compilación progresiva, avisos inofensivos y errores frecuentes).
- Plantilla publicada en la galería de Overleaf enlazada desde README, docs y llms.txt, con Overleaf posicionado como alternativa al trabajo en local.
- Tablas de diagnóstico de CLAUDE.md, AGENTS.md y copilot-instructions.
- Bump de versión 2.2.1 -> 2.2.2 y fecha 2026/08/02 en todos los marcadores.

Claude-Session: https://claude.ai/code/session_01Epzb5ew6f4SZADUzy9nJd3

Author: jmrplens

.github/copilot-instructions.md

@@ -1,7 +1,7 @@
 # Instrucciones para GitHub Copilot — Plantilla TFG/TFM EPS UA
 
 Plantilla LaTeX para TFG/TFM de la Escuela Politécnica Superior (EPS),
-Universidad de Alicante. Versión 2.2.1 (2026).
+Universidad de Alicante. Versión 2.2.2 (2026).
 
 ---
 
@@ -434,6 +434,7 @@ Pedir siempre las últimas 30 líneas de `main.log`.
 
 | Error | Solución |
 | --- | --- |
+| `TeX capacity exceeded [main memory size=5000000]` | Compilar con LuaLaTeX (Overleaf: Menu → Compiler → LuaLaTeX) |
 | `You must invoke LaTeX with -shell-escape` | Usar `make` o añadir `-shell-escape` |
 | `Pygments not found` | `pip install latexminted` |
 | `Citation 'X' undefined` | Ejecutar `make` completo (biber) |

.herramientas/actualizar_previews.py

@@ -9,7 +9,7 @@
 Autor:    José Manuel Requena Plens
 Enlace:   https://github.com/jmrplens/TFG-TFM_EPS
 Licencia: MIT
-Versión:  2.2.1
+Versión:  2.2.2
 --------------------------------------------------------------------------------
 
 Este script:

.herramientas/generar_portadas.py

@@ -9,7 +9,7 @@
 Autor:    José Manuel Requena Plens
 Enlace:   https://github.com/jmrplens/TFG-TFM_EPS
 Licencia: MIT
-Versión:  2.2.1
+Versión:  2.2.2
 --------------------------------------------------------------------------------
 
 Este script:

.latexmkrc

@@ -19,6 +19,23 @@ $pdf_mode = 4;  # 4 = lualatex
 # Comando de LuaLaTeX con opciones necesarias
 $lualatex = 'lualatex -shell-escape -interaction=nonstopmode -file-line-error -synctex=1 %O %S';
 
+# ----------------------------------------------------------------------------
+# COMPATIBILIDAD CON OVERLEAF (y con `latexmk -pdf` / `-pdfxe` / `-pdfdvi`)
+# ----------------------------------------------------------------------------
+# Overleaf ignora la línea mágica «% !TeX program = lualatex» y elige el motor
+# desde Menu -> Compiler, pasándolo por línea de órdenes (-pdf, -pdfxe...).
+# Las opciones de la línea de órdenes tienen prioridad sobre $pdf_mode, así que
+# un proyecto importado a Overleaf compilaría con pdfLaTeX o XeLaTeX y fallaría
+# («TeX capacity exceeded», memoria fija de esos motores).
+#
+# Redirigimos esos motores a LuaLaTeX: así el proyecto compila en Overleaf
+# aunque el menú «Compiler» no esté en LuaLaTeX. latexmk detecta que la salida
+# es PDF en vez de XDV/DVI y ajusta la cadena automáticamente.
+# En la compilación normal (pdf_mode = 4) estas variables NO se usan.
+$pdflatex = 'lualatex -shell-escape -interaction=nonstopmode -file-line-error -synctex=1 %O %S';
+$xelatex  = 'lualatex -shell-escape -interaction=nonstopmode -file-line-error -synctex=1 %O %S';
+$latex    = 'lualatex -shell-escape -interaction=nonstopmode -file-line-error -synctex=1 %O %S';
+
 # Máximo número de iteraciones
 $max_repeat = 5;
 

AGENTS.md

@@ -18,7 +18,7 @@ opere sobre este repositorio.
 Plantilla LaTeX para Trabajos de Fin de Grado (TFG) y Máster (TFM) de la
 Escuela Politécnica Superior (EPS) de la Universidad de Alicante (UA).
 
-- **Versión:** 2.2.1 (2026)
+- **Versión:** 2.2.2 (2026)
 - **Motor de compilación:** LuaLaTeX (obligatorio, nunca pdfLaTeX)
 - **Clase principal:** `cls/eps-tfg.cls` (basada en KOMA-Script `scrbook`)
 - **Bibliografía:** BibLaTeX + Biber, estilo APA 7
@@ -308,6 +308,8 @@ Formato de entrada en `referencias.bib`:
 
 | Error en `.log` | Causa | Solución |
 | --- | --- | --- |
+| `TeX capacity exceeded [main memory size=5000000]` | Casi siempre, motor incorrecto (XeLaTeX/pdfLaTeX, de memoria fija); si el motor ya es LuaLaTeX, revisar el contexto en `main.log` (macro recursiva, documento enorme) | Compilar con LuaLaTeX; en Overleaf, Menu → Compiler → LuaLaTeX (`docs/OVERLEAF.md`) |
+| `ESTA PLANTILLA REQUIERE LuaLaTeX` | Guard de motor de la plantilla: el motor no es LuaTeX | Compilar con LuaLaTeX (`make`) |
 | `Undefined control sequence \EPSsetup` | `configuracion.tex` cargado antes de la clase | Verificar orden en `main.tex` |
 | `You must invoke LaTeX with -shell-escape` | Falta flag en compilación | Usar `make` o añadir `-shell-escape` |
 | `Pygments not found` | `latexminted` no instalado | `pip install latexminted` |

CHANGELOG.md

@@ -5,6 +5,30 @@ Todos los cambios notables de este proyecto serán documentados en este archivo.
 El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/),
 y este proyecto adhiere a [Versionado Semántico](https://semver.org/lang/es/).
 
+## [2.2.2] - 2026-08-02
+
+### Añadido
+
+- **Guía de Overleaf**: Nueva guía `docs/OVERLEAF.md` (importación, selección de
+  compilador, límites de compilación, avisos normales y errores frecuentes)
+- **Plantilla publicada en la galería de Overleaf**, enlazada desde el README,
+  `docs/OVERLEAF.md`, `docs/README.md`, `docs/GUIA_PRINCIPIANTES.md` y `llms.txt`
+- **Botón «Abrir en Overleaf»** en el README, que crea el proyecto con el motor
+  LuaLaTeX ya seleccionado (`engine=lualatex`)
+- **Comprobación de motor** en `cls/eps-metadata.tex`: si se compila con
+  pdfLaTeX o XeLaTeX, la compilación se detiene con un mensaje explicativo en
+  lugar del error críptico `TeX capacity exceeded, sorry [main memory size=5000000]`
+
+### Corregido
+
+- **Compatibilidad con Overleaf**: `.latexmkrc` redirige los motores `pdflatex`,
+  `xelatex` y `latex` a LuaLaTeX. Overleaf ignora la línea mágica
+  `% !TeX program = lualatex` y pasa el motor por línea de órdenes (prioritaria
+  sobre `$pdf_mode`), por lo que los proyectos importados fallaban al compilar
+  con XeLaTeX/pdfLaTeX
+
+---
+
 ## [2.1.0] - 2026-02-06
 
 ### Añadido

CITATION.cff

@@ -2,8 +2,8 @@ cff-version: 1.2.0
 message: "Si utilizas esta plantilla, por favor cítala como se indica a continuación."
 type: software
 title: "Plantilla LaTeX TFG/TFM — Escuela Politécnica Superior (Universidad de Alicante)"
-version: 2.2.1
-date-released: 2026-07-11
+version: 2.2.2
+date-released: 2026-08-02
 doi: "10.5281/zenodo.21315904"
 authors:
   - family-names: "Requena Plens"

CLAUDE.md

@@ -1,7 +1,7 @@
 # CLAUDE.md — Instrucciones para Claude
 
 Plantilla LaTeX para TFG/TFM de la Escuela Politécnica Superior (EPS),
-Universidad de Alicante. Versión 2.2.1 (2026).
+Universidad de Alicante. Versión 2.2.2 (2026).
 
 Motor: **LuaLaTeX** (obligatorio). Bibliografía: **BibLaTeX + Biber** (APA 7).
 Código: **minted 3.x** con `latexminted`.
@@ -476,6 +476,8 @@ Si el usuario reporta un error, pedir las últimas 30 líneas de `main.log`.
 
 | Error | Causa probable | Solución |
 | --- | --- | --- |
+| `TeX capacity exceeded [main memory size=5000000]` | Causa más probable: se está compilando con XeLaTeX/pdfLaTeX (memoria fija). También puede deberse a una macro recursiva o a un documento desmesurado | Comprobar primero el motor: usar LuaLaTeX (en Overleaf: Menu → Compiler → LuaLaTeX). Si ya se usa LuaLaTeX, revisar el contexto del error en `main.log`. Ver `docs/OVERLEAF.md` |
+| `ESTA PLANTILLA REQUIERE LuaLaTeX` | Guard de motor en `cls/eps-metadata.tex`: el motor no es LuaTeX | Compilar con LuaLaTeX (`make`, o en Overleaf Menu → Compiler → LuaLaTeX) |
 | `Undefined control sequence` | Comando no definido o paquete no cargado | Verificar módulo de componentes activo |
 | `You must invoke LaTeX with -shell-escape` | Falta flag | Usar `make` o añadir `-shell-escape` |
 | `Pygments not found` | Python/minted no instalado | `pip install latexminted` |

Makefile

@@ -5,7 +5,7 @@
 # Autor:    José Manuel Requena Plens
 # Enlace:   https://github.com/jmrplens/TFG-TFM_EPS
 # Licencia: MIT
-# Versión:  2.2.1
+# Versión:  2.2.2
 # ==============================================================================
 #
 # Comandos disponibles:

README.md

@@ -4,8 +4,9 @@ Universidad de Alicante
 
 [![LaTeX](https://img.shields.io/badge/LaTeX-LuaLaTeX-008080?logo=latex)](https://www.latex-project.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/Versión-2.2.1-blue.svg)](https://github.com/jmrplens/TFG-TFM_EPS/releases)
+[![Version](https://img.shields.io/badge/Versión-2.2.2-blue.svg)](https://github.com/jmrplens/TFG-TFM_EPS/releases)
 [![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.21315904-blue?logo=doi&logoColor=white)](https://doi.org/10.5281/zenodo.21315904)
+[![Overleaf](https://img.shields.io/badge/Overleaf-Plantilla%20publicada-47A141?logo=overleaf&logoColor=white)](https://www.overleaf.com/latex/templates/plantilla-latex-2026-tfg-y-tfm-para-la-eps-de-la-universidad-de-alicante-bachelors-slash-masters-thesis-template/qjntjjjpfjvv)
 [![listed on awesome-comunitat-valenciana](https://img.shields.io/badge/listed%20on-awesome--comunitat--valenciana-FFB81C?style=flat&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxNCAxNCI+PGcgZmlsbD0iI0ZGQjgxQyI+PHJlY3QgeD0iNiIgeT0iMiIgd2lkdGg9IjIiIGhlaWdodD0iNCIvPjxyZWN0IHg9IjQiIHk9IjQiIHdpZHRoPSIyIiBoZWlnaHQ9IjIiLz48cmVjdCB4PSI4IiB5PSI0IiB3aWR0aD0iMiIgaGVpZ2h0PSIyIi8+PHJlY3QgeD0iMiIgeT0iMyIgd2lkdGg9IjIiIGhlaWdodD0iNCIvPjxyZWN0IHg9IjEwIiB5PSIzIiB3aWR0aD0iMiIgaGVpZ2h0PSI0Ii8+PHJlY3QgeD0iMCIgeT0iMiIgd2lkdGg9IjIiIGhlaWdodD0iMyIvPjxyZWN0IHg9IjEyIiB5PSIyIiB3aWR0aD0iMiIgaGVpZ2h0PSIzIi8+PHJlY3QgeD0iNSIgeT0iOCIgd2lkdGg9IjQiIGhlaWdodD0iMiIvPjxyZWN0IHg9IjQiIHk9IjEwIiB3aWR0aD0iNiIgaGVpZ2h0PSIyIi8+PHJlY3QgeD0iNSIgeT0iMTIiIHdpZHRoPSIyIiBoZWlnaHQ9IjIiLz48cmVjdCB4PSI3IiB5PSIxMiIgd2lkdGg9IjIiIGhlaWdodD0iMiIvPjwvZz48L3N2Zz4=&labelColor=0056A0)](https://github.com/GeiserX/awesome-comunitat-valenciana#readme)
 
 Plantilla LaTeX moderna y profesional para la elaboración de **Trabajos de Fin de Grado (TFG)** y **Trabajos de Fin de Máster (TFM)** de la Escuela Politécnica Superior de la Universidad de Alicante.
@@ -22,7 +23,7 @@ Plantilla LaTeX moderna y profesional para la elaboración de **Trabajos de Fin
 - 📊 **Gráficas y diagramas** con TikZ/PGFPlots
 - 📖 **Glosarios y acrónimos** integrados
 - 🚀 **Optimización TikZ** con caché de figuras
-- 🔧 **Compatible con Overleaf** y editores locales
+- 🔧 **Pensada para trabajar en local** (VS Code, TeXstudio…) y **compatible con Overleaf**
 
 ---
 
@@ -54,6 +55,7 @@ Esta plantilla incluye una documentación exhaustiva para cada aspecto de tu TFG
 
 | Guía | Descripción |
 | ------ | ------------- |
+| 🌐 [Uso en Overleaf](docs/OVERLEAF.md) | Plantilla en la galería, compilador LuaLaTeX, límites de compilación y errores |
 | 📝 [Código Fuente](docs/CODIGO_FUENTE.md) | Insertar y resaltar código con minted (40+ lenguajes) |
 | 📊 [Figuras y Gráficas](docs/FIGURAS_GRAFICAS.md) | Crear gráficos con pgfplots y TikZ |
 | 🖼️ [Imágenes y Subfiguras](docs/IMAGENES_SUBFIGURAS.md) | Incluir imágenes, subfiguras y posicionamiento |
@@ -562,12 +564,38 @@ Los colores de las titulaciones se definen en la clase. Para personalizar:
 
 ## 🌐 Uso en Overleaf
 
+[![Plantilla en Overleaf](https://img.shields.io/badge/Overleaf-Abrir%20plantilla-47A141?logo=overleaf&logoColor=white)](https://www.overleaf.com/latex/templates/plantilla-latex-2026-tfg-y-tfm-para-la-eps-de-la-universidad-de-alicante-bachelors-slash-masters-thesis-template/qjntjjjpfjvv)
+
+Overleaf es una **alternativa** al trabajo en local (ver [Inicio
+Rápido](#-inicio-rápido)) para quien no quiera instalar nada o necesite
+colaborar en línea, a cambio de los límites de compilación de la plataforma.
+
+**Dentro de Overleaf, la vía más cómoda:** abre la
+[plantilla publicada en la galería](https://www.overleaf.com/latex/templates/plantilla-latex-2026-tfg-y-tfm-para-la-eps-de-la-universidad-de-alicante-bachelors-slash-masters-thesis-template/qjntjjjpfjvv)
+y pulsa *Open as Template*: el proyecto se crea con el compilador y la versión
+de TeX Live ya configurados.
+
+Si prefieres subir este repositorio completo (con todo el contenido de ejemplo),
+puedes usar [este enlace](https://www.overleaf.com/docs?snip_uri=https://github.com/jmrplens/TFG-TFM_EPS/archive/refs/heads/main.zip&engine=lualatex)
+o hacerlo a mano:
+
 1. Sube todos los archivos del proyecto a Overleaf
-2. Configura el compilador como **LuaLaTeX**
-3. Activa **shell-escape** en la configuración del proyecto
+2. **Menu → Compiler → LuaLaTeX** ⚠️ *paso imprescindible*
+3. **Menu → TeX Live version → 2025** (o la más reciente)
 4. Compila `main.tex`
 
-> ⚠️ **Nota:** Algunas funcionalidades como minted requieren shell-escape habilitado.
+> ⚠️ **Overleaf ignora la línea `% !TeX program = lualatex`** de `main.tex`: el
+> motor se elige solo desde el menú *Compiler*. Con pdfLaTeX o XeLaTeX la
+> compilación falla con `TeX capacity exceeded, sorry [main memory size=5000000]`
+> porque el preámbulo de la plantilla no cabe en la memoria fija de esos motores.
+> El `.latexmkrc` del proyecto redirige el motor a LuaLaTeX como red de
+> seguridad, pero conviene ajustar el menú igualmente.
+>
+> 💡 `shell-escape` (necesario para minted) lo activa Overleaf automáticamente al
+> detectar el paquete; no hay que configurar nada.
+
+📖 **Guía completa:** [`docs/OVERLEAF.md`](docs/OVERLEAF.md) — importación,
+límites de compilación, avisos normales y solución de errores.
 
 ---