Estruture uma tese de pós-graduação em LaTeX antes que o pânico chegue

Elementos pré-textuais, capítulos em arquivos separados, siglas, classes da universidade, velocidade de compilação e histórico no Git para estudantes de mestrado e doutorado.

A tese é um texto longo com burocracia anexada. O LaTeX cuida bem do texto longo. A burocracia costuma ser uma classe da universidade escrita em 2009 e testada pela última vez em outra versão do TeX Live.

Comece a estrutura cedo, mesmo que os capítulos ainda estejam vazios. Mover conteúdo entre arquivos no último mês é o que quebra referências cruzadas e caminhos de figuras.

Aceite a classe da universidade e isole o resto

Coloque no projeto o .cls da universidade (e os arquivos .bst e de logotipo exigidos). Não reescreva a classe. Ponha as suas macros, pacotes e o conteúdo dos capítulos em arquivos que você controla:

thesis/
main.tex
macros.tex
chapters/
figures/
university.cls

Se a classe quebrar em um motor moderno, faça a triagem com classes de universidade que não compilam. Registre qual motor a secretaria de pós-graduação aceita (pdfLaTeX, XeLaTeX ou LuaLaTeX) antes de investir no fontspec.

Elementos pré-textuais que as bancas esperam

Numeração romana para resumo, dedicatória, agradecimentos, sumário e listas de figuras e tabelas; arábica para os capítulos principais. As classes book e report oferecem \frontmatter / \mainmatter; os modelos baseados em article exigem \pagenumbering manual. Guia: páginas romanas e depois arábicas.

O conteúdo da folha de rosto muitas vezes precisa seguir um modelo em Word da pós-graduação. Copie o texto exatamente. Criatividade aqui faz o PDF ser recusado por um checklist.

Capítulos como arquivos

Uma raiz, vários includes:

\include{chapters/intro}
\include{chapters/background}
\include{chapters/methods}
\include{chapters/results}
\include{chapters/conclusion}

Cuide dos capítulos você mesmo, mesmo quando coautores ajudam nos artigos que alimentam a tese. Mantenha as figuras em figures/chapter3/ para que os caminhos continuem estáveis quando você reordenar. Use \includeonly{chapters/methods} durante o rascunho para que a compilação da tese inteira não seja o custo de cada edição de equação: um arquivo raiz, vários capítulos.

Os rótulos devem ser únicos no projeto todo (eq:ch3-main, e não eq:main em todo arquivo). Visões de estrutura do projeto inteiro e verificação de referências ao vivo ajudam numa árvore de 200 páginas.

Siglas e símbolos

Os pacotes de glossário são poderosos e exigentes. Para muitas teses, uma lista de símbolos mantida à mão nos elementos pré-textuais basta. Se você precisa de siglas que se expandem sozinhas, reserve um dia para aprender o glossaries-extra antes da semana da entrega, não durante ela.

Defina as macros matemáticas em macros.tex e trate esse arquivo como lei compartilhada. Uma notação que muda entre o capítulo 2 e o capítulo 5 é um presente para um examinador pedante.

Bibliografia

Um único .bib para a tese inteira, ou um conjunto pequeno mesclado com cuidado. Chaves estáveis. Valide antes da encadernação provisória: validador de BibTeX. Siga o estilo que o programa exige (numérico, autor-data, estilos de humanidades com muitas notas de rodapé). Não misture biblatex e o BibTeX clássico no mesmo preâmbulo.

Velocidade

As compilações da tese inteira ficam lentas. O modo rascunho para figuras, o \includeonly e o externalize do TikZ devolvem horas. Notas: menos espera pelo PDF.

Faça toda semana o ritual da “compilação completa” para ainda ver cedo as falhas entre capítulos.

Backup não é o mesmo que histórico

Uma cópia no Dropbox é um backup. O Git é a história de como o argumento mudou. Faça um commit quando um capítulo compilar. Envie para um remoto privado no GitHub ou no GitLab.

O Oleafly (abre em uma nova guia) inicializa um repositório de verdade por projeto, cria pontos de verificação depois de compilações bem-sucedidas e quando você para de editar, e restaura com um clique, ao lado de visões de estrutura do projeto inteiro e de um SyncTeX que continua funcionando entre os arquivos de capítulo. Isso torna o hábito mais difícil de pular. Você consegue a mesma disciplina com qualquer editor e um Git bem usado; a tese não deve depender de você lembrar de rodar git init no mês dezoito.

Ciclos de feedback com a banca

Exporte um PDF para os leitores que não vão abrir o código-fonte. Acompanhe os comentários em issues ou em um documento compartilhado, mas aplique as edições no TeX. Quando um membro da banca devolver um PDF com anotações escaneadas, nomeie o arquivo com data e versão para saber a qual commit do código-fonte ele se referia.

Checklist para a encadernação simples e a capa dura

Antes de imprimir ou depositar:

  • A classe e o motor correspondem às regras da secretaria de pós-graduação.
  • A numeração das páginas iniciais está correta; a folha de assinaturas está presente, se exigida.
  • Todos os \ref/\cite são resolvidos; nenhum [?].
  • Figuras e tabelas listadas, se exigido; legendas consistentes.
  • Margens e tamanho da fonte passam no PDF de checklist (imprima uma página de teste).
  • Código-fonte + PDF + hash do commit arquivados depois do depósito.

Figuras, tabelas e páginas de “lista de”

Muitas secretarias exigem uma lista de figuras e de tabelas. As legendas devem ser consistentes e não despejar a seção de métodos inteira numa legenda de 20 linhas. Use títulos curtos para as listas e legendas explicativas mais longas no corpo do texto, se a classe aceitar legendas curtas opcionais.

Plágio e publicações anteriores

Se os capítulos reaproveitam artigos publicados, siga as regras da universidade sobre inclusão e autorização dos coautores. Mantenha sob controle de versão o PDF aceito de cada artigo anterior e o capítulo da tese, com uma nota sobre o que mudou (notação, experimentos ampliados, introdução unificada).

Comece neste mês, não no mês em que for escrever

Crie o esqueleto quando propuser o plano da tese. Capítulos vazios que compilam contam como progresso. A maior parte do pânico de fim de prazo é dívida de estrutura somada a uma classe teimosa, não uma lacuna na ciência. Pague essa dívida cedo.

Todas as postagens