| name | latex-render |
| description | Compiles a .tex file to PDF using latexmk, then deletes all auxiliary files (log, aux, out, fls, fdb_latexmk, synctex.gz). Called automatically after latex-writer finishes, or manually when the user asks to compile/render a LaTeX file. |
LaTeX Render
When to use this skill
- Automáticamente: llamada por
latex-writer o exercise-solver después de escribir un .tex.
- Manualmente: cuando el usuario dice "compila", "renderiza", "genera el PDF", "limpia los auxiliares".
Input
| Campo | Descripción |
|---|
tex_path | Ruta absoluta al archivo .tex a compilar |
Si no se entrega tex_path, buscar el .tex más reciente en el directorio de trabajo o en output/ del directorio mencionado en la conversación.
Execution Protocol
Paso 1 — Verificar que el archivo existe
ls -lh {tex_path}
Si no existe, detener y avisar.
Paso 2 — Compilar con latexmk
Usar latexmk con -pdf y -interaction=nonstopmode para no quedarse colgado ante warnings. Compilar dos veces implícitamente (latexmk lo maneja solo para referencias cruzadas).
latexmk -f -pdf -interaction=nonstopmode -output-directory={output_dir} {tex_path}
-f fuerza la recompilación aunque latexmk crea que el output está actualizado. Sin este flag, cambios recientes en el .tex pueden no reflejarse en el PDF.
donde {output_dir} es el directorio que contiene el .tex.
Si latexmk no está disponible (verificar con which latexmk), usar pdflatex dos veces:
pdflatex -interaction=nonstopmode -output-directory={output_dir} {tex_path}
pdflatex -interaction=nonstopmode -output-directory={output_dir} {tex_path}
Paso 3 — Verificar el PDF
ls -lh {output_dir}/{basename}.pdf
Si el PDF no fue generado, el archivo .log contiene el error. Leerlo y reportar las líneas relevantes al usuario (buscar líneas que empiecen con !):
grep "^!" {output_dir}/{basename}.log | head -20
Paso 4 — Limpiar auxiliares
Solo si el PDF fue generado correctamente. Eliminar todos los archivos auxiliares dejando únicamente el .tex y el .pdf:
rm -f {output_dir}/{basename}.aux
rm -f {output_dir}/{basename}.log
rm -f {output_dir}/{basename}.out
rm -f {output_dir}/{basename}.fls
rm -f {output_dir}/{basename}.fdb_latexmk
rm -f {output_dir}/{basename}.synctex.gz
rm -f {output_dir}/{basename}.toc
rm -f {output_dir}/{basename}.lof
rm -f {output_dir}/{basename}.lot
rm -f {output_dir}/{basename}.bbl
rm -f {output_dir}/{basename}.blg
O en una sola línea usando la extensión glob:
latexmk -c -output-directory={output_dir} {tex_path}
latexmk -c limpia todos los auxiliares generados en la última compilación sin tocar el .pdf ni el .tex.
Paso 4.5 — Aplicar efecto de escaneo analógico (Por Defecto)
Para generar una versión realista que parezca un papel físico escaneado con imperfecciones de digitalización, ejecutar el script de escaneo:
/home/fabian/.gemini/antigravity/brain/64388d7a-2956-45a5-ad09-098974b25c84/scratch/scan_effect.py {output_dir}/{basename}.pdf {output_dir}/{basename}_scanned.pdf
Este script aplica:
- Geometría asimétrica: Rotación aleatoria a $\pm 1.0^\circ$, traslación y cizalladura (shear) aleatoria para simular el deslizamiento del rodillo sobre el papel.
- Suciedad de cristal/sensor: Probabilidad del 40% de dibujar una línea difusa vertical muy fina (típica línea de polvo en escáneres).
- Iluminación desigual: Un gradiente sutil de iluminación en los bordes simulando sombra de curvatura de papel.
- Respuesta del sensor: Curva de contraste más agresiva ($1.25$) y grano analógico más marcado (ruido monocromático más alto).
Paso 5 — Confirmar
ls {output_dir}/
Reportar al usuario:
- Ruta del PDF generado.
- Tamaño del PDF.
- Lista de lo que quedó en el directorio (solo
.tex, .pdf y opcionalmente los archivos escaneados deberían quedar).
Integración con otras skills
latex-writer debe llamar esta skill al final de su protocolo de escritura, pasando la ruta del .tex recién creado. El flujo completo queda:
exercise-solver
└─▶ latex-writer (escribe solution.tex)
└─▶ latex-render (compila → PDF, limpia auxiliares, aplica scan_effect.py → solution_scanned.pdf)
Error Handling
| Situación | Acción |
|---|
Error de compilación (! en el log) | Mostrar el error, no borrar auxiliares (el log ayuda a depurar) |
pdflatex y latexmk ausentes | Avisar al usuario que instale texlive |
El .tex tiene \input{} o \include{} | Compilar desde el directorio del .tex para que las rutas relativas funcionen |
| PDF ya existe y la compilación falla | Conservar el PDF anterior, no sobreescribirlo con un archivo corrupto |
Constraints
- Solo limpiar si el PDF fue generado con éxito. Nunca borrar auxiliares si la compilación falló.
- Nunca borrar el
.tex ni el .pdf.
- No modificar el
.tex antes de compilar — solo compilar lo que latex-writer entregó.
