Всё, что выше begin{document}

Пакеты, метаданные и порядок загрузки: что относится к преамбуле, а что нет.

Всё, что выше begin{document}

Всё, что находится между \documentclass{...} и \begin{document}, называется преамбулой. Она не выводит видимого текста, а настраивает сборку. Здесь живут шрифты, поля, пакеты, собственные команды и метаданные документа, поэтому преамбула зрелой статьи нередко длиннее её введения. Когда вы понимаете, что делает каждая строка, скопированный шаблон перестаёт быть магией и становится контрольным списком.

Устройство

\documentclass[11pt,a4paper]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[margin=1in]{geometry}
\usepackage{amsmath,amssymb}
\usepackage{graphicx,booktabs}
\usepackage{hyperref} % load late
\title{Title}
\author{You}
\date{\today}

Параметры \documentclass задают глобальные значения по умолчанию: 11pt — базовый размер шрифта, от которого отсчитывается всё остальное, а a4paper объявляет размер бумаги. Две строки с кодировками — исторические спутники: inputenc сообщает движку, что исходный файл в UTF-8, а fontenc выбирает кодировку шрифта, чтобы символы с диакритикой были настоящими глифами, а не составными. Современный LaTeX уже считает ввод UTF-8, поэтому в новых документах эти строки часто опускают, но вреда от них нет, и шаблоны оставляют их ради совместимости.

Средний блок подключает пакеты с дополнительными возможностями. geometry задаёт поля одним параметром, amsmath и amssymb дают математические среды и символы, нужные почти каждому техническому документу, graphicx включает \includegraphics для рисунков, а booktabs добавляет линейки, благодаря которым таблицы выглядят профессионально. Наконец, hyperref делает ссылки и цитаты кликабельными и намеренно загружается последним, потому что переопределяет внутренние части многих других пакетов.

Строки \title, \author и \date только сохраняют метаданные. Ничего не печатается, пока в теле документа не выполнится \maketitle, поэтому их вообще можно держать в преамбуле.

Практические правила

Несколько привычек помогают держать преамбулу в порядке. Загружайте по одному пакету на каждую задачу и не нагромождайте пакеты, которые спорят за одну и ту же область, например два способа задать поля. Держите hyperref в конце, с несколькими документированными исключениями вроде cleveref, который должен идти после него. Общие для документа решения указывайте в параметрах класса, а не разбрасывайте по файлу: так 11pt или twocolumn объявлено один раз на виду у всех. А когда ваши собственные макросы перерастут несколько строк, вынесите их в файл .sty, чтобы несколько документов могли пользоваться одним набором определений.

Самая полезная дисциплина — от противного: если вы не знаете, зачем в преамбуле нужна какая-то строка, выясните это, прежде чем документ начнёт на неё опираться. В скопированных преамбулах копятся мёртвые строки, а в мёртвых строках прячутся конфликты пакетов. См. также каркас документа и сравнение движков.

Проверка: преамбулаНеобязательный тренировочный тестВопросов: 5

Короткая проверка по материалу урока. При неверном ответе показывается правильный. Варианты перемешиваются при каждой попытке. Проходить заново можно сколько угодно.

Вернуться к Открыть цикл