Sumário, listas de figuras e listas de tabelas

O tableofcontents e por que a segunda compilação importa.

Sumário, listas de figuras e listas de tabelas

Um sumário em LaTeX não é algo que você monta nem mantém. Você coloca um único comando onde quer que ele apareça, e o LaTeX monta as entradas a partir dos títulos que você já escreveu. O mesmo vale para a lista de figuras e a lista de tabelas, que reúnem legendas em vez de títulos. É um dos pontos em que declarar a estrutura compensa diretamente: renomeie uma seção ou mova uma figura e a parte inicial do documento se corrige sozinha.

Os três comandos

\tableofcontents
\listoffigures
\listoftables

O \tableofcontents imprime o sumário no ponto em que aparece, normalmente logo depois da folha de rosto ou do resumo. Todo \chapter, \section e \subsection numerado aparece com número, título e página, até a profundidade definida pelo contador tocdepth, descrito na lição sobre títulos. O \listoffigures e o \listoftables fazem o mesmo para as legendas de figuras e tabelas, tirando o texto de cada \caption{...}. Em artigos eles são incomuns, mas teses costumam exigir os dois, cada um em sua própria página depois do sumário.

Por que a segunda compilação importa

Compile duas vezes depois de mudanças na estrutura. Isso não é superstição. É como o mecanismo funciona. Durante uma compilação, o LaTeX não tem como saber, na página 2, o que vai parar na página 47, então grava cada título e o seu número de página final em um arquivo auxiliar (.toc, .lof, .lot) à medida que avança. O \tableofcontents lê o arquivo que sobrou da execução anterior. Em um projeto novo esse arquivo ainda não existe, e por isso a primeira compilação produz um sumário vazio. Depois que você adiciona ou move seções, o sumário mostra títulos desatualizados ou números de página errados até a próxima execução. A segunda compilação lê o arquivo recém-gravado e tudo se alinha. Editores que rodam o latexmk ou um script equivalente cuidam das repetições para você, e é por isso que talvez você nunca tenha reparado. Se o seu sumário parecer errado, compile mais uma vez antes de depurar qualquer outra coisa.

Seções com asterisco e o sumário

Seções com asterisco precisam de \addcontentsline{toc}{section}{Title} se devem aparecer no sumário. Um título com asterisco como \section*{Acknowledgments} dispensa de propósito tanto a numeração quanto o arquivo de índice, então, se você quer que ele conste na lista, precisa adicionar a entrada por conta própria. Os três argumentos do comando são o arquivo onde gravar (toc), o nível da entrada (section) e o texto a exibir. Coloque a linha imediatamente depois do título com asterisco, para que o número de página registrado esteja certo.

Um hábito que vale cultivar: antes de compartilhar um PDF, olhe o sumário em busca dos sinais típicos de uma compilação desatualizada, como pontos de interrogação, entradas faltando ou uma última entrada que para antes do seu capítulo final. Quase sempre se resolve com mais uma compilação. Perceber isso você mesmo sai mais barato do que um parecerista perceber. A mesma dança de arquivos auxiliares move o \ref e companhia, tema das referências cruzadas.

Voltar para O esqueleto do artigo