Índice general, lista de figuras y lista de tablas

tableofcontents y por qué importa la segunda pasada.

Índice general, lista de figuras y lista de tablas

En LaTeX, el índice general no es algo que se construya ni se mantenga a mano. Colocas un solo comando donde lo quieres y LaTeX monta las entradas a partir de los títulos que ya has escrito. Lo mismo ocurre con la lista de figuras y la lista de tablas, que recogen leyendas en lugar de títulos. Es uno de los lugares donde declarar la estructura da un beneficio directo: renombra una sección o mueve una figura y las páginas preliminares se corrigen solas.

Los tres comandos

\tableofcontents
\listoffigures
\listoftables

\tableofcontents imprime el índice general en el punto donde aparece, normalmente justo después de la portada o del resumen. Cada \chapter, \section y \subsection numerado aparece con su número, su título y su página, hasta la profundidad que fija el contador tocdepth descrito en la lección de los títulos. \listoffigures y \listoftables hacen lo mismo con las leyendas de figuras y de tablas, tomando el texto de cada \caption{...}. En los artículos son poco habituales, pero las tesis suelen exigir ambas, colocadas en páginas propias después del índice general.

Por qué importa la segunda pasada

Compila dos veces tras los cambios de estructura. No es superstición. Así es como funciona el mecanismo. Durante una compilación, LaTeX no puede saber en la página 2 qué acabará en la página 47, así que va escribiendo cada título y su número de página definitivo en un archivo auxiliar (.toc, .lof, .lot). \tableofcontents lee el archivo que quedó de la ejecución anterior. En un proyecto nuevo ese archivo todavía no existe, así que la primera compilación produce un índice vacío. Después de añadir o mover secciones, el índice muestra títulos desactualizados o números de página erróneos hasta la siguiente ejecución. La segunda compilación lee el archivo recién escrito y todo cuadra. Los editores que ejecutan latexmk o un envoltorio equivalente se ocupan de las repeticiones por ti, y por eso quizá nunca lo hayas notado. Si tu índice alguna vez se ve mal, compila una vez más antes de depurar cualquier otra cosa.

Secciones con asterisco y el índice general

Las secciones con asterisco necesitan \addcontentsline{toc}{section}{Title} si deben aparecer en el índice general. Un título con asterisco como \section*{Acknowledgments} se salta a propósito tanto la numeración como el archivo de contenidos, así que, si quieres que figure en la lista, añades tú mismo la entrada. Los tres argumentos del comando son el archivo en el que escribir (toc), el nivel de la entrada (section) y el texto que se mostrará. Pon la línea justo después del título con asterisco para que el número de página registrado sea correcto.

Un hábito que conviene adquirir: antes de compartir un PDF, echa un vistazo al índice general en busca de las señales delatoras de una compilación desactualizada, como signos de interrogación, entradas que faltan o una última entrada que se queda corta respecto a tu capítulo final. Casi siempre se cura con una compilación más. Detectarlo tú mismo sale más barato que si lo detecta un revisor. El mismo baile de archivos auxiliares es lo que hace funcionar \ref y compañía, que se tratan en referencias cruzadas.

Volver a El esqueleto del artículo