Оглавление, списки рисунков и списки таблиц
tableofcontents и почему важен второй проход.
Оглавление, списки рисунков и списки таблиц
Оглавление в LaTeX не нужно строить или поддерживать. Вы ставите одну команду там, где оно должно быть, а LaTeX собирает записи из уже написанных вами заголовков. То же относится к списку рисунков и списку таблиц, которые собирают подписи вместо заголовков. Это одно из мест, где объявление структуры окупается напрямую: переименуйте раздел или переместите рисунок, и вводная часть исправится сама.
Три команды
\tableofcontents\listoffigures\listoftables\tableofcontents печатает оглавление в том месте, где стоит, обычно сразу после титульной страницы или аннотации. Каждая нумерованная \chapter, \section и \subsection попадает в него с номером, названием и страницей, вплоть до глубины, заданной счётчиком tocdepth, о котором говорится в уроке о заголовках. \listoffigures и \listoftables делают то же для подписей к рисункам и таблицам, беря текст из каждого \caption{...}. В статьях они встречаются редко, а вот диссертации обычно требуют оба списка, каждый на своей странице после оглавления.
Почему важен второй проход
После структурных изменений компилируйте дважды. Это не суеверие, а то, как устроен механизм. Во время компиляции LaTeX не может знать на странице 2, что окажется на странице 47, поэтому по ходу работы записывает каждый заголовок и его итоговый номер страницы во вспомогательный файл (.toc, .lof, .lot). \tableofcontents читает файл, оставшийся от предыдущего запуска. В новом проекте такого файла ещё нет, поэтому первая компиляция даёт пустое оглавление. После добавления или перемещения разделов оглавление показывает устаревшие названия или неверные номера страниц до следующего запуска. Вторая компиляция читает только что записанный файл, и всё встаёт на места. Редакторы, которые запускают latexmk или аналогичную обёртку, выполняют повторные запуски за вас, поэтому вы могли ни разу этого не замечать. Если оглавление выглядит неправильно, скомпилируйте ещё раз, прежде чем искать причину где-то ещё.
Разделы со звёздочкой и оглавление
Разделам со звёздочкой нужна \addcontentsline{toc}{section}{Title}, если они должны попасть в оглавление. Заголовок со звёздочкой, например \section*{Acknowledgments}, намеренно пропускает и нумерацию, и файл оглавления, поэтому, если хотите видеть его в списке, добавляйте запись сами. Три аргумента команды: файл, в который пишем (toc), уровень записи (section) и отображаемый текст. Ставьте эту строку сразу после заголовка со звёздочкой, чтобы записанный номер страницы был верным.
Стоит выработать привычку: перед тем как отправлять PDF, взгляните на оглавление и поищите характерные признаки устаревшей сборки, такие как знаки вопроса, пропавшие записи или последняя запись, не доходящая до вашей последней главы. Почти всегда лечится ещё одной компиляцией. Заметить это самому дешевле, чем если заметит рецензент. Тот же обмен вспомогательными файлами лежит в основе \ref и родственных команд, о которых рассказано в уроке о перекрёстных ссылках.