Archivos de clase universitarios que no compilan
Diagnóstico: primer error, motor, paquetes obsoletos y búsqueda binaria.
Archivos de clase universitarios que no compilan
Las plantillas de tesis universitarias son un tipo especial de código heredado. Hace quince años un estudiante de posgrado escribió el archivo de clase para la distribución de TeX de entonces, se graduó y lo dejó congelado mientras el ecosistema de LaTeX seguía avanzando. Cuando hoy descargas universitythesis.cls y se cae con una pantalla de errores, la clase normalmente no está tanto rota como varada en el tiempo. Los modos de fallo, eso sí, son previsibles, y un orden fijo de diagnóstico resuelve la mayoría.
Empieza solo con el primer error
Un fallo de LaTeX se propaga en cascada: un solo comando indefinido al principio de la clase puede producir decenas de errores posteriores que no significan nada. Desplázate por el registro hasta la primera línea que empiece por !, corrígela y recompila antes de leer nada más. Repetir este ciclo suele despejar un muro de errores intimidante en tres o cuatro pasadas. Si el primer error es un comando desconocido, Undefined control sequence explica el diagnóstico.
Comprueba el motor
Muchas plantillas dan por hecho un motor concreto y fallan de forma extraña con cualquier otro. Una clase que carga fontspec o que fija las fuentes por nombre necesita XeLaTeX o LuaLaTeX; una clase construida sobre primitivas específicas de pdftex puede fallar con ambos. Busca un comentario cerca del principio del archivo de clase, o una línea en las instrucciones de la universidad, que nombre el motor previsto, y usa ese antes de depurar cualquier otra cosa. Las diferencias se resumen en Qué motor usar en este proyecto.
Moderniza lo que controlas
Las plantillas antiguas cargan paquetes obsoletos cuyos reemplazos modernos ya están en tu distribución, y entonces los dos se pelean; Paquetes que se pelean entre sí enumera las combinaciones clásicas. La estrategia viable es dejar en paz el propio archivo de clase, porque ahí viven los requisitos de formato de la universidad, y modernizar solo tu propio preámbulo: quita las líneas \usepackage obsoletas, carga hyperref al final y evita volver a cargar nada que la clase ya cargue.
Búsqueda binaria en el preámbulo
Cuando el error se resiste a la inspección, comenta la segunda mitad de tu preámbulo y recompila. Si el error desaparece, el origen está en la mitad comentada; restaura la mitad de ella y repite. Unas pocas compilaciones aíslan la línea culpable, mucho más rápido que razonar sobre un preámbulo que no escribiste tú.
Busca antes de sufrir
Todos los estudiantes de esa universidad compilan la misma clase, así que casi seguro que alguien ya se topó con tu error. Busca el mensaje de error exacto junto con el nombre del archivo de clase y comprueba si la universidad o algún estudiante posterior mantiene un fork corregido en GitHub. Usar un fork mantenido, cuando existe, es mejor que volver a corregir por tu cuenta errores ya conocidos.