Soporte y preguntas frecuentes
El PDF no se genera
Sección titulada «El PDF no se genera»Síntoma: el ODP se crea correctamente pero el PDF no aparece, o aparece
un error como LibreOffice falló (código 1).
Causa más frecuente: LibreOffice no está instalado o no está en el PATH.
# Verificar que LibreOffice está disponiblelibreoffice --version
# Instalar en Ubuntu/Debiansudo apt-get install -y libreofficeSi usas el AppImage full, LibreOffice está incluido. Si usas el slim, necesitas LibreOffice instalado en el sistema.
Para omitir la generación de PDF:
./temario build --no-pdf courses/mi-curso“LibreOffice no encontrado” al usar el AppImage full
Sección titulada «“LibreOffice no encontrado” al usar el AppImage full»Si el AppImage full falla al exportar a PDF con un error de soffice.bin,
asegúrate de que la versión descargada es v0.1.5 o superior — las versiones
anteriores tenían un problema con las rutas internas de LibreOffice.
La plantilla no se detecta correctamente
Sección titulada «La plantilla no se detecta correctamente»Síntoma: los slides generados no tienen el diseño esperado, o Temario usa la plantilla por defecto en lugar de la tuya.
Verificar:
- El fichero
template.yamlexiste encourses/<curso>/template/ - Los índices de diapositiva en
template.yamlson correctos (0-based) - El fichero ODP referenciado en
template.yamlestá en el mismo directorio
# Regenerar template.yaml desde el ODP./temario import courses/mi-curso/template/mi-plantilla.odpLos estilos del ODP no coinciden con el diseño esperado
Sección titulada «Los estilos del ODP no coinciden con el diseño esperado»Síntoma: los textos aparecen con el estilo por defecto, no con el de la plantilla.
Los nombres de estilo en template.yaml deben coincidir exactamente con
los definidos en el ODP. Ábrelo en LibreOffice → Estilos → Gestionar estilos
para ver los nombres exactos y actualiza template.yaml manualmente.
El watch no detecta cambios
Sección titulada «El watch no detecta cambios»Síntoma: ./temario build --watch muestra “Watching N fichero(s)…” pero no
regenera al guardar.
Causa más frecuente: el paquete watchdog no está instalado.
uv sync --group watch./temario build --watch courses/mi-cursoSegunda causa: el editor tiene el autoguardado activo. Con autoguardado, el editor guarda el fichero en cada pulsación de tecla y el watch regenera constantemente. Desactívalo (ponlo a 0 segundos) mientras uses watch.
El build falla con “debe estar dentro de courses//content/”
Sección titulada «El build falla con “debe estar dentro de courses//content/”»Síntoma: error ValueError: ... debe estar dentro de <courses_dir>/<curso>/content/
al intentar generar una presentación desde el GUI.
Causa: el directorio de cursos se cambió desde los Ajustes del GUI sin reiniciar la aplicación. En versiones anteriores a 0.1.7-beta2, la ruta interna quedaba obsoleta.
Solución: actualizar a 0.1.7-beta2 o posterior. Como solución temporal, reinicia
el GUI tras cambiar courses_dir en los ajustes.
Error al instalar: “uv: command not found”
Sección titulada «Error al instalar: “uv: command not found”»curl -LsSf https://astral.sh/uv/install.sh | shsource ~/.local/bin/env # o abrir nuevo terminalLa GUI no arranca: errores de librerías Qt
Sección titulada «La GUI no arranca: errores de librerías Qt»En Ubuntu 24.04, instala las dependencias de sistema:
sudo apt-get install -y libxcb-cursor0 libxkbcommon-x11-0Los slides se dividen en demasiados fragmentos [N/M]
Sección titulada «Los slides se dividen en demasiados fragmentos [N/M]»Temario divide automáticamente código largo (>20 líneas) y listas grandes (>14 ítems). Para ajustar los umbrales:
./temario config set generation.code_split_lines 30./temario config set generation.list_split_items 20¿Dónde reportar un bug?
Sección titulada «¿Dónde reportar un bug?»Abre un issue en el repositorio del proyecto:
gitlab.com/pepesan/temario-app → Issues
Incluye la versión (./temario version), el sistema operativo y el mensaje
de error completo.