Распространённые пакеты и советы в LaTeX

В предыдущих главах уже использовалось довольно много пакетов; эта статья систематически подводит итог: краткий справочник по пакетам, пользовательские команды, вёрстка кода, многофайловые проекты, latexmk и приёмы устранения неполадок.

Освойте эти темы из «ящика инструментов», и вы перейдёте от написания LaTeX к управлению LaTeX-проектами.


Краткий справочник по распространённым пакетам

Подключайте пакеты с помощью \usepackage[options]{package-name}, все они размещаются в преамбуле.

ПакетНазначениеВстречается в этой серии
geometryПоля страницы и бумагаСтруктура документа и вёрстка в LaTeX
fancyhdrКолонтитулыСтруктура документа и вёрстка в LaTeX
amsmath / amssymbУлучшение математических формул / расширенные символыОсновы математических формул в LaTeX、Продвинутые математические формулы в LaTeX
graphicxРисункиРисунки и таблицы в LaTeX
booktabs / multirowBooktabs / вертикально объединённые ячейкиРисунки и таблицы в LaTeX
enumitemНастройка списковФорматирование текста и списки в LaTeX
xcolorОпределение цветаВведено в этой главе
listingsВёрстка кодаВведено в этой главе
hyperrefГиперссылки и закладкиПерекрёстные ссылки и управление библиографией в LaTeX
biblatexБиблиография (современный подход)Перекрёстные ссылки и управление библиографией в LaTeX
floatПринудительное размещение рисунков и таблиц [H]Рисунки и таблицы в LaTeX

Когда локальное окружение выдаёт сообщение File 'xxx.sty' not found, используйте tlmgr install xxx для установки (TeX Live); MiKTeX загрузит автоматически. В Overleaf есть почти все пакеты, поэтому такой проблемы не возникнет.


Пользовательские команды: \newcommand

Когда вы набрали одно и то же содержимое более трёх раз, пора определить команду. \newcommand{\command-name}[number-of-parameters]{definition}.

{...}$ даёт x_1, … , x_5

% Без параметров: сократить длинную команду
\newcommand{\R}{\mathbb{R}}            % С этого момента запись $\R$ даёт $\mathbb{R}$

% Один параметр: обернуть в фиксированный формат
\newcommand{\email}[1]{\texttt{#1}}   % #1 обозначает первый параметр

% Необязательный параметр со значением по умолчанию: [число параметров][значение по умолчанию]
\newcommand{\vecn}[2][n]{x_1, \dots, x_#1}
% Использование: $\vecn{...}$ даёт x_1, … , x_n
% $\vecn

\begin{document}
определена на$\R$функция на, вектор$\vecn$и$\vecn[5]$,
Контактная электронная почта\электронная почта{service@example.com}。
\end{document
}
КомандаНазначениеПримечание
\newcommandОпределить новую командуИмя команды не должно конфликтовать с существующими командами
\renewcommandПереопределить существующую командуИспользуйте при изменении стилей по умолчанию; будьте осторожны с базовыми командами
\newenvironmentОпределить новое окружениеСинтаксис такой же, как выше; укажите код начала и конца

Давайте также изучим синтаксис для пользовательских окружений:

Пример: пользовательское окружение "Note"

\newenvironment{note}                 % Имя окружения
  {\par\medskip\noindent\textbf{Note:}\itshape}  % Начало кода
  {\par\medskip}                      % Конец кода

\begin{note}
Содержимое здесь автоматически начнётся с "Note:" и будет набрано курсивом.
\end{note
}

Вёрстка кода: пакет listings

Чтобы включить код в технические документы, используйте пакет listings; подсветка синтаксиса, номера строк и рамки — всё это автоматически.

Пример: блок кода с подсветкой и номерами строк

\documentclass{ctexart}
\usepackage{listings
}             % Пакет для вёрстки кода
\usepackage{xcolor}               % Поддержка цвета

\lstset{                          % Глобальные настройки стиля кода
  basicstyle=\ttfamily\small,     % Моноширинный шрифт, чуть меньший размер шрифта
  keywordstyle=\color{blue},      % Ключевые слова синим
  commentstyle=\color{gray},      % Комментарии серым
  stringstyle=\color{purple},     % Строки фиолетовым
  numbers=left,                   % Номера строк слева
  numberstyle=\tiny\color{gray},
  showstringspaces=false,         % Не отображать маркеры пробелов внутри строк
  frame=single                    % Однолинейная рамка
}

\begin{document}

\begin{lstlisting}[language=Python, caption=Вычисление последовательности Фибоначчи]
# Вычислить n-е число Фибоначчи (тест китайского комментария)
def fib(n):
    if n < 2:
        return n
    return fib(n - 1) + fib(n - 2)

print(fib(10)) # Вывод 55
\end{lstlisting}

\end{document
}

listings 代码块的编译效果

lstlisting — это окружение verbatim: его содержимое вообще не интерпретируется LaTeX, а & и % не нужно экранировать. Подпись также автоматически нумеруется (Листинг 1). К распространённым названиям языков относятся Python, C, Java, HTML, SQL, bash и т. д. Если язык не указан, он окрашивается как обычный текст.

Поддержка китайского текста в UTF-8 в listings зависит от компилятора: китайские комментарии нормально работают под XeLaTeX; в устаревших движках (latex/pdfLaTeX) они превращаются в абракадабру. Для документов на китайском языке всегда компилируйте с XeLaTeX.


Многофайловые проекты: \input и \include

Когда документ превышает несколько сотен строк, его следует разбить на файлы — main.tex служит только скелетом, а содержимое делится по принципу «разделяй и властвуй».

Пример: скелет main.tex

\documentclass{ctexart}
\usepackage{amsmath, graphicx, booktabs, hyperref}

\begin{document}

\input{chapters/intro
}      % Введение (имя файла без .tex)
\input{chapters/method}     % Методы
\input{chapters/experiment} % Эксперименты
\input{chapters/conclusion} % Заключение

\bibliographystyle{plain}
\bibliography{refs}

\end{document
}

Эти две команды выглядят похоже, но их поведение чётко разделено.

Пункт сравнения\input{file}\include{file}
Можно ли вкладывать?Да (дальнейший \input внутри подфайлов)Нет
Принудительно разрывает страницу?Без разрыва страницыПринудительно вызывает \clearpage перед каждым файлом
Работает с \includeonlyНе поддерживаетсяПоддерживается; позволяет компилировать только указанные главы (отличный инструмент ускорения)
Применимая гранулярностьЛюбой сегмент (определения макросов, рисунки/таблицы, титульные страницы)Крупные блоки содержимого уровня главы

Распространённая ошибка: \include принудительно разрывает страницу. Использование его для сборки "нескольких разделов на одной странице" приведёт к неожиданным разрывам страниц — используйте \input для небольших фрагментов.


latexmk: компиляция в один клик

Четырёхпроходный конвейер компиляции из главы 9 утомительно вводить вручную в виде четырёх команд; latexmk выполняет его полностью автоматически.

$ latexmk -xelatex main.tex     # XeLaTeX 引擎编译,自动跑满所有遍数
$ latexmk -xelatex -c main.tex  # 清理中间文件(保留 PDF)
$ latexmk -xelatex -C main.tex  # 连 PDF 一起清理

latexmk автоматически решает: если есть файл .bib, он запускает bibtex; если перекрёстные ссылки меняются, он компилирует ещё несколько раз, пока все номера не стабилизируются. Настройка "команды сборки" в вашем редакторе как latexmk — лучшая практика для локального окружения.


Методы устранения неполадок

Сообщения об ошибках LaTeX начинаются с восклицательного знака и включают номер строки; формат фиксированный. Достаточно понять первые несколько строк.

! Undefined control sequence.
l.42 \secton{方法}

l.42 указывает на строку с ошибкой — в этом примере в строке 42 \section написано с ошибкой как \secton. Исправьте это одно место, и цепочка последующих ошибок часто исчезает целиком.

Сообщение об ошибкеЗначениеОбработка
Неопределённая управляющая последовательностьКоманда не существует: опечатка или отсутствующий пакетПроверьте написание по номеру строки; убедитесь, что пакет загружен
Вставлен отсутствующий $Математическая команда появляется в текстовом режимеПоместите _ ^ \alpha и т. д. внутрь $
Файл 'xxx' не найденФайл или пакет не найденПроверьте путь; tlmgr install xxx
Убегающий аргументОкружение не закрыто (отсутствует \end)Добавьте \end{...} в соответствии с номером строки
Ошибка LaTeX: окружение xxx не определеноИспользовано неопределённое окружениеПроверьте написание окружения и пакет
! Аварийная остановкаКомпиляция полностью прерванаПрокрутите журнал вверх, чтобы найти первую ошибку
Ссылка не определена (предупреждение)Ссылка отображается как ??Скомпилируйте ещё раз

Всегда исправляйте только первую ошибку в журнале — последующие ошибки в основном являются каскадными следствиями первой. После исправления перекомпилируйте; это гораздо надёжнее, чем менять десять мест сразу.


Итог

НужноРешение
Сократите повторяющийся ввод\newcommand определяет команды и окружения
Вставьте кодlistings + \lstset: глобальный стиль
Разделение большого документа\input (фрагмент) / \include (уровень главы)
Компиляция в один кликlatexmk -xelatex
ОтладкаПрочитайте номер строки первой ошибки ! в журнале
Другие расширения