LaTeX для документов: установка и первый шаблон

LaTeX остаётся стандартом для научных статей, дипломов, технической документации и книг, где важны ссылки, формулы и единая вёрстка. В Linux Mint и Ubuntu полный набор ставится из репозитория, но новичка пугает размер и обилие пакетов. Ниже — минимальная установка, первый шаблон на русском и команды для ежедневной работы.

Что ставить

Не начинайте с texlive-full: это несколько гигабайт, большая часть которых не нужна. Для статей и отчётов хватает latex-recommended, шрифтов, русской локализации и latexmk. Дополнительные пакеты доставляйте по мере появления ошибок «File … not found».

sudo apt update
sudo apt install texlive-latex-recommended texlive-fonts-recommended
sudo apt install texlive-lang-cyrillic texlive-latex-extra latexmk
latexmk -v

Пакет texlive-latex-extra тянет booktabs, geometry, titlesec и ещё сотни стилей. Для библиографии добавьте texlive-bibtex-extra и biber. Если нужен исходный TeX Live с менеджером tlmgr, ставьте его отдельным установщиком: версия из apt tlmgr не поддерживает.

Первый документ

Создайте каталог проекта и файл main.tex. В преамбуле подключите кодировку, русский язык, геометрию страницы и гиперссылки. Порядок подключения babel и fontenc важен: сначала fontenc, затем babel, иначе переносы и типографика работают неправильно.

\documentclass[12pt,a4paper]{article}
\usepackage[T2A]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[english,russian]{babel}
\usepackage[margin=2cm]{geometry}
\usepackage{graphicx}
\usepackage{hyperref}
\title{Первый документ}
\author{Иван Петров}
\begin{document}
\maketitle
\tableofcontents
\section{Введение}
Текст с формулой $E = mc^2$ и ссылкой \url{https://example.com}.
\end{document}

Собирайте через latexmk -pdf main.tex: утилита сама запускает pdflatex столько раз, сколько нужно для оглавления и ссылок. Флаг -pvc включает пересборку при сохранении файла. Результат — main.pdf в том же каталоге.

XeLaTeX и системные шрифты

Если нужен шрифт из системы, например DejaVu Serif или Liberation Serif, используйте XeLaTeX или LuaLaTeX вместе с fontspec. В этом режиме inputenc и fontenc не нужны, а русский язык подключается через babel или polyglossia. Команда latexmk -xelatex выбирает нужный движок автоматически.

\usepackage{fontspec}
\usepackage{polyglossia}
\setmainlanguage{russian}
\setotherlanguage{english}
\setmainfont{DejaVu Serif}
\setsansfont{DejaVu Sans}

Проверить наличие шрифта можно через fc-list | grep -i dejavu. Если шрифт не найден, XeLaTeX сообщит об этом в логе, а не заменит его молча, — это удобно для отладки.

Таблицы, рисунки, код

Для аккуратных таблиц подключайте booktabs и не рисуйте вертикальные линии. Изображения вставляйте через graphicx с указанием width; файлы держите в подкаталоге figures. Листинги кода удобно оформлять через listings, а minted даёт подсветку, но требует python3-pygments и флага -shell-escape.

\usepackage{booktabs}
\usepackage{listings}
\begin{table}[h]
\centering
\caption{Сводка за два года}
\begin{tabular}{lrr}
\toprule
Метрика & 2025 & 2026 \\
\midrule
Запросы & 1200 & 1450 \\
Ошибки & 12 & 7 \\
\bottomrule
\end{tabular}
\end{table}

Ссылки на объекты ставьте через \label и \ref, а не вручную: тогда номера обновятся сами. Для кода используйте \lstinputlisting{src/example.py} — так листинг не расходится с реальным файлом.

Формулы и перекрёстные ссылки

Для нумерованных формул используйте окружение equation, для многострочных — align из amsmath. Не набирайте номера вручную: \label и \eqref свяжут формулу с текстом, и при вставке новой формулы нумерация пересчитается сама. Пакет amsmath входит в latex-recommended, отдельная установка не нужна.

\usepackage{amsmath}
\begin{equation}
\label{eq:norm}
\|x\|_2 = \sqrt{\sum_{i=1}^{n} x_i^2}
\end{equation}
Как видно из \eqref{eq:norm}, норма неотрицательна.

Для теорем и определений подключите amsthm и заведите свои окружения в преамбуле. Единый стиль оформления важнее количества пакетов: проверяющий быстрее найдёт нужное, если структура предсказуема.

• Ссылки на разделы — \ref{sec:intro}, на рисунки — \ref{fig:scheme}.
• Подписи ставьте под рисунком и над таблицей, как принято в издательской практике.
• Не используйте \textbf для смысловых акцентов, для этого есть \emph.
• Проверяйте лог на предупреждения о неопределённых ссылках.

Библиография

Современный вариант — biblatex с движком biber. Записи хранятся в refs.bib, вывод — командой \printbibliography. После добавления источника latexmk сам запустит biber, если увидит изменения в .bib или .tex.

\usepackage[backend=biber,style=authoryear]{biblatex}
\addbibresource{refs.bib}
...
\cite{knuth1984}
\printbibliography

Русские источники оформляйте с полем language=russian; для ГОСТ-стиля существует пакет biblatex-gost, но проверьте требования вашего вуза или издательства перед сдачей.

Структура проекта и git

Держите исходники в git, а вспомогательные файлы — в .gitignore. PDF можно коммитить, если он нужен заказчику, но обычно достаточно тега с версией. Отдельный каталог figures и отдельный refs.bib упрощают совместную работу.

main.tex
refs.bib
figures/
src/
latexmkrc
.gitignore

Файл latexmkrc позволяет зафиксировать движок и каталог сборки: $pdf_mode = 1 для pdflatex, 5 для xelatex. Тогда команда latexmk без флагов делает правильную вещь, и это не нужно помнить каждому участнику.

Диагностика ошибок

Первая ошибка в логе важнее последней: дальнейшие сообщения часто её следствие. Ищите строку с восклицательным знаком, затем читайте контекст. Неизвестный пакет ищется через kpsewhich или apt-file search; отсутствующий шрифт — через fc-list.

kpsewhich geometry.sty
apt-file search booktabs.sty
grep -n -A3 '^!' main.log
latexmk -C

Команда latexmk -c удаляет вспомогательные файлы, но оставляет PDF; ключ -C с большой буквы чистит и его. Если сборка зависла на вопросе об ошибке, запускайте с -interaction=nonstopmode или добавьте эту опцию в latexmkrc.

Отдельная частая проблема — конфликт пакетов после обновления дистрибутива. Если документ собирался год назад, зафиксируйте версии в контейнере или собирайте в отдельном каталоге с собственным TeX Live. Перед сдачей прогоните сборку с нуля: удалите aux-файлы и вызовите latexmk -pdf, так вы увидите ошибки, которые скрывает старый кэш.

Чек-лист

• Ставьте только нужные пакеты TeX Live, остальное добавляйте по ошибке.
• Кодировку UTF-8 и T2A подключайте до babel.
• Собирайте через latexmk, а не ручными вызовами pdflatex.
• Ссылки, подписи и библиографию оформляйте командами, не вручную.
• Исходники храните в git, вспомогательные файлы — в .gitignore.

Итог

LaTeX в Linux ставится за несколько минут, если не тащить полный дистрибутив. Начните с минимального набора, соберите шаблон через latexmk и добавляйте пакеты по мере необходимости. Главное — не бороться с ошибками по одной, а читать первую строку лога и проверять наличие файла через kpsewhich. Для больших проектов полезно собирать PDF в контейнере с закреплённой версией TeX Live.