Archivos de clases universitarias que no se compilarán

Las plantillas de tesis universitarias son un tipo especial de código heredado. Un estudiante de posgrado escribió el archivo de la clase hace quince años contra la distribución TeX del momento, se graduó y lo dejó congelado mientras el ecosistema LaTeX avanzaba. Cuando descargas universitythesis.cls hoy y muere con una pantalla de errores, la clase generalmente no se interrumpe sino que se queda varada en el tiempo. Sin embargo, los modos de falla son predecibles y un orden de clasificación fijo resuelve la mayoría de ellos.

Comience solo con el primer error

Un fallo de LaTeX se produce en cascada: un comando indefinido al principio de la clase puede producir docenas de errores posteriores que no significan nada. Desplácese por el registro hasta la primera línea que comienza con !, solucione eso y vuelva a compilar antes de leer cualquier otra cosa. Repetir este bucle a menudo elimina un muro de error intimidante en tres o cuatro pasadas. Si el primer error es un comando desconocido, Secuencia de control indefinida recorre el diagnóstico.

Revisa el motor

Muchas plantillas asumen un motor específico y fallan extrañamente con cualquier otro. Una clase que carga fontspec o establece fuentes por nombre requiere XeLaTeX o LuaLaTeX; una clase construida alrededor de primitivas específicas de pdftex puede fallar en ambos. Busque un comentario cerca de la parte superior del archivo de la clase o una línea en las instrucciones de la universidad que nombre el motor deseado y conéctelo antes de depurar cualquier otra cosa. Las diferencias se resumen en Qué motor para este proyecto.

Moderniza lo que controlas

Las plantillas antiguas cargan paquetes obsoletos cuyos reemplazos modernos ya están en su distribución, y luego la pareja pelea; Paquetes que luchan entre sí enumera las combinaciones clásicas. La estrategia viable es dejar el archivo de clase en sí, ya que los requisitos de formato de la universidad residen allí, y modernizar sólo su propio preámbulo: eliminar líneas obsoletas \usepackage, cargar hyperref tarde y evitar volver a cargar todo lo que la clase ya carga.

Búsqueda binaria en el preámbulo

Cuando el error resista la inspección, comente la segunda mitad de su preámbulo y vuelva a compilar. Si el error desaparece, el desencadenante está en la mitad comentada; restaure la mitad y repita. Un puñado de compilaciones aísla la única línea errónea, lo cual es mucho más rápido que razonar sobre un preámbulo que no escribiste.

Busca antes de sufrir

Todos los estudiantes de esa universidad compilan la misma clase, por lo que es casi seguro que su error ya se haya producido antes. Busque el mensaje de error exacto junto con el nombre del archivo de la clase y verifique si la universidad o un estudiante sucesor mantiene una bifurcación parcheada en GitHub. Usar una bifurcación mantenida, cuando existe, es mejor que volver a corregir errores conocidos por tu cuenta.