Classes de universidade que não compilam
Triagem: primeiro erro, motor, pacotes obsoletos e busca binária.
Classes de universidade que não compilam
Os modelos de tese das universidades são um tipo especial de código legado. Um aluno de pós-graduação escreveu o arquivo de classe há quinze anos para a distribuição TeX da época, se formou e o deixou congelado enquanto o ecossistema do LaTeX seguia em frente. Quando você baixa o universitythesis.cls hoje e ele morre com uma tela de erros, em geral a classe não está tanto quebrada quanto encalhada no tempo. Os modos de falha, porém, são previsíveis, e uma ordem fixa de triagem resolve a maioria deles.
Comece apenas pelo primeiro erro
Uma falha do LaTeX se propaga em cascata: um comando indefinido no início da classe pode produzir dezenas de erros adiante que não significam nada. Role o log até a primeira linha que começa com !, corrija-a e recompile antes de ler qualquer outra coisa. Repetir esse ciclo muitas vezes limpa um muro intimidador de erros em três ou quatro passadas. Se o primeiro erro for um comando desconhecido, Undefined control sequence conduz o diagnóstico.
Verifique o motor
Muitos modelos pressupõem um motor específico e falham de maneira bizarra em qualquer outro. Uma classe que carrega o fontspec ou define fontes pelo nome exige XeLaTeX ou LuaLaTeX; uma classe construída em torno de primitivas específicas do pdftex pode falhar nos dois. Procure um comentário perto do início do arquivo de classe, ou uma linha nas instruções da universidade, que indique o motor pretendido, e use o mesmo antes de depurar qualquer outra coisa. As diferenças estão resumidas em Qual motor para este projeto.
Modernize o que você controla
Modelos antigos carregam pacotes obsoletos cujos substitutos modernos já estão na sua distribuição, e aí os dois brigam; Pacotes que brigam entre si lista as combinações clássicas. A estratégia viável é deixar o arquivo de classe em paz, já que é lá que ficam as exigências de formatação da universidade, e modernizar só o seu próprio preâmbulo: remover as linhas \usepackage obsoletas, carregar o hyperref por último e evitar recarregar qualquer coisa que a classe já carrega.
Faça uma busca binária no preâmbulo
Quando o erro resiste à inspeção, comente a segunda metade do seu preâmbulo e recompile. Se o erro desaparecer, o gatilho está na metade comentada; restaure metade dela e repita. Um punhado de compilações isola a única linha culpada, o que é muito mais rápido do que raciocinar sobre um preâmbulo que você não escreveu.
Pesquise antes de sofrer
Todo aluno daquela universidade compila a mesma classe, então é quase certo que o seu erro já apareceu antes. Pesquise a mensagem de erro exata junto com o nome do arquivo de classe e veja se a universidade, ou um aluno que veio depois, mantém um fork corrigido no GitHub. Usar um fork mantido, quando existe, é melhor do que corrigir sozinho bugs já conhecidos.