Table of contents, list of figures, list of tables — LaTeX

Содержание, список рисунков, список таблиц

Синтаксис, один из:

\tableofcontents
\listoffigures
\listoftables

Создайте таблицу содержания, список рисунков или список таблиц. Вставьте команду в файл ввода в том месте, где вы хотите разместить таблицу или список. Вы не вводите записи; например, обычно записи таблицы содержания автоматически генерируются из команд разбиения текста \chapter, и т. д.

Этот пример иллюстрирует первую команду, \tableofcontents. LaTeX создаст таблицу содержания на первой странице книги.

\documentclass{book}
% \setcounter{tocdepth}{1}
\begin{document}
\tableofcontents\newpage
  ...
\chapter{...}
  ...
\section{...}
  ...
\subsection{...}
  ...
\end{document}

Раскомментирование второй строки приведет к тому, что эта таблица будет содержать списки глав и разделов, но не списки подразделов, потому что команда \section имеет уровень 1. См. Разбиение на разделы для номеров уровней секционирования. Подробнее о tocdepth см. Sectioning/tocdepth.

Еще один пример использования \tableofcontents приведен в Шаблоне для больших book документов.

Если вы хотите перенос страницы после таблицы содержания, напишите команду \newpage после команды \tableofcontents, как показано выше.

Для создания таблицы содержания LaTeX сохраняет информацию в вспомогательный файл с именем root-file.toc (см. Разбиение ввода). Например, этот файл LaTeX test.tex

\documentclass{article}
\begin{document}
\tableofcontents\newpage
\section{First section}
\subsection{First subsection}
  ...

записывает эти строки в test.toc.

\contentsline {section}{\numberline {1}First section}{2}
\contentsline {subsection}{\numberline {1.1}First subsection}{2}

Каждая строка содержит одну команду, \contentsline (см. \contentsline). Первый аргумент, section или subsection, — это единица разбиения на разделы. Второй аргумент состоит из двух компонентов. Привязка \numberline определяет, как номер разбиения, 1 или 1.1, отображается в таблице содержания (см. \numberline). Остальная часть второго аргумента \contentsline, «Первый раздел» или «Первый подраздел», — это текст заголовка раздела. Наконец, третий аргумент, «2», — это номер страницы, на которой начинается этот элемент разбиения.

Для форматирования этих строк класс документа предоставляет команды, такие как \l@section-unit и \l@section{text}{pagenumber}. Эти команды часто используют команду \@dottedtocline (см. \@dottedtocline).

Следствие стратегии LaTeX по использованию вспомогательных файлов заключается в том, что для получения правильной информации в документе необходимо выполнить LaTeX дважды: один раз для хранения информации, а второй — для её извлечения. В обычном процессе написания документа авторы запускают LaTeX несколько раз, но вы можете заметить, что в первый раз при компиляции нового документа страница таблицы содержания будет пустой, за исключением заголовка «Содержание». Просто запустите LaTeX еще раз.

Команды \listoffigures и \listoftables создают список рисунков и список таблиц. Их информация сохраняется в файлах с расширением .lof и .lot. Они работают так же, как \tableofcontents, но последнее используется чаще, поэтому мы используем его в большинстве примеров.

Вы можете вручную добавлять материал в таблицу содержания, список рисунков и список таблиц. Например, добавьте строку о разделе в таблицу содержания с помощью \addcontentsline{toc}{section}{text}. (см. \addcontentsline). Добавьте произвольный материал, то есть нелинейный материал, с \addtocontents, как в команде \addtocontents{lof}{\protect\vspace{2ex}}, которая добавляет вертикальный отступ в список рисунков (см. \addtocontents).

Строки в таблице содержания, списке рисунков и списке таблиц имеют четыре части. Сначала отступ. Затем — поле для номеров разделов, а затем — поле для текста заголовка, например «Первый раздел». Наконец, есть поле у правого края, внутри которого LaTeX размещает поле с номером страницы. Для отступа и ширины поля с номером см. \@dottedtocline. Ширина поля правого края — \@tocrmarg, а номер страницы выровнен по правому краю в этом поле, внутри поля шириной \@pnumwidth. По умолчанию \@tocrmarg — 2.55em, а \@pnumwidth — 1.55em. Изменить их можно с помощью \renewcommand{\@tocrmarg}{3.5em}.

CTAN содержит множество пакетов для таблицы содержания и списков рисунков и таблиц (см. CTAN: Комплексная сеть архивов TeX). Пакет tocloft удобен для настройки некоторых аспектов по умолчанию, таких как интервалы. А tocbibbind автоматически добавит библиографию, указатель и т. д. в таблицу содержания.

Чтобы изменить заголовок страницы таблицы содержания, выполните действия, подобные этим командам, перед вызовом \tableofcontents, и т. д.

\renewcommand{\contentsname}{Table of Contents}
\renewcommand{\listfigurename}{Plots}
\renewcommand{\listtablename}{Specifications}

Пакеты интернационализации, такие как babel или polyglossia, изменят эти заголовки в зависимости от выбранного языка.