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.clsSe 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/\citesã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.