\addcontentsline

Синопсис:

\addcontentsline{ext}{unit}{text}

Добавить запись в вспомогательный файл с расширением ext.

В результате этого в оглавлении появится строка «Приложения».

\addcontentsline{toc}{section}{\protect\textbf{Appendices}}

Она будет отображаться на том же уровне вложенности, что и разделы, будет выделена жирным шрифтом и будет присвоена номер страницы, соответствующей месту команды в исходном файле.

Команда \addcontentsline записывает информацию в файл root-name.ext, где root-name — имя корневого файла (см. Разбиение входных данных). Она записывает эту информацию как текст команды \contentsline{unit}{text}{num}, где num — текущее значение счётчика unit (см. \contentsline). Наиболее распространённый случай — оглавление, где num — номер страницы первой страницы unit.

Эта команда вызывается командами разбиения на разделы \chapter, и т. д. (см. Разбиение на разделы), а также командой \caption внутри среды плавающего объекта (см. Плавающие объекты). Но авторы также могут её использовать напрямую. Например, автор, который пишет книгу со введением без номера, может использовать звёздочную команду \chapter*. Однако эта команда опускает информацию о содержании оглавления, которую можно ввести вручную, как показано здесь.

\chapter*{Preface}
\addcontentsline{toc}{chapter}{\protect\numberline{}Preface}

В файле root-name.toc LaTeX поместит строку \contentsline {chapter}{\numberline {}Preface}{3}; обратите внимание, что номер страницы «3» автоматически генерируется системой, а не вводится вручную.

Все аргументы для \addcontentsline обязательны.

ext

Обычно это одна из строк toc для оглавления, lof для списка фигур или lot для списка таблиц. Расширение имени файла информационного файла.

unit

Строка, которая зависит от значения аргумента ext, обычно одна из следующих:

toc

Для оглавления это имя секционного блока: part, chapter, section, subsection, и т. д.

lof

Для списка фигур: figure.

lot

Для списка таблиц: table.

text

Текст записи. Вы должны \protect все хрупкие команды (см. \protect), используемые в нём.

Команда \addcontentsline взаимодействует с командой \include (см. \include & \includeonly). Если вы используете их на одном уровне, как с \addcontentsline{...}{...}{...}\include{...}, то строки в оглавлении могут отображаться в неправильном порядке. Решение — переместить \addcontentsline в включаемый файл.

Если вы используете unit, который LaTeX не распознаёт, как в этом случае с ошибкой

\addcontentsline{toc}{setcion}{\protect\textbf{Appendices}}

то вы не получите ошибки, но форматирование в оглавлении будет бессмысленным.