Страница PDF как рисунок
includegraphics с выбором страницы и pdfpages для приложений.
Страница PDF как рисунок
PDF — лучший формат рисунков, который может использовать LaTeX. В отличие от PNG или JPG, PDF хранит векторные данные, поэтому линии и подписи остаются чёткими при любом увеличении, а шрифты внутри него путешествуют вместе с файлом. Matplotlib, Inkscape и draw.io экспортируют PDF, а значит, диаграмма, нарисованная где-то в другом месте, сразу ложится в ваш документ. Но у PDF есть одна особенность, которой нет у изображений: в PDF может быть много страниц, и вы должны сообщить LaTeX, какая из них вам нужна.
Выбор одной страницы из многостраничного PDF
Команда \includegraphics пакета graphicx принимает опцию page наряду с обычными ключами размера:
\includegraphics[page=1,width=\textwidth]{diagram.pdf}Здесь page=1 выбирает первую страницу файла diagram.pdf, а width=\textwidth масштабирует эту страницу до полной ширины текстового блока. Если опустить page, LaTeX молча возьмёт первую страницу; обычно это то, что нужно, но может удивить, когда скрипт построения графиков записывает несколько рисунков в один файл. Один и тот же PDF можно включать несколько раз с разными значениями page, по разу в каждом окружении figure, со своей подписью и своей меткой.
Оберните команду в обычное окружение figure, чтобы рисунок получил подпись и номер, точно так же, как любое другое изображение. Включённая страница обрезается по собственной ограничивающей рамке, поэтому если в исходном PDF большие поля, рисунок будет выглядеть с лишними отступами. Переэкспортируйте файл с плотной рамкой или один раз обрежьте его инструментом вроде pdfcrop, а не воюйте с пустым местом отрицательными интервалами.
Вставка целых документов через pdfpages
Иногда рисунок вам вовсе не нужен. Нужны целые страницы, дословно вставленные в ваш документ: дополнительный PDF, подписанная форма, опубликованная анкета в приложении к диссертации. Это работа пакета pdfpages:
\usepackage{pdfpages}\includepdf[pages=-]{supplement.pdf}Значение pages=- означает все страницы. Можно также написать pages=2-5 для диапазона или pages={1,3,7} для конкретного списка. Каждая вставленная страница занимает отдельную страницу результата, сохраняет исходную вёрстку и участвует в нумерации страниц вашего документа, так что приложение читается непрерывно. Добавьте опцию pagecommand={}, если колонтитулы из класса вашего документа печатаются поверх вставленных страниц и вы хотите их убрать или настроить.
Какой инструмент для какой задачи
Используйте \includegraphics[page=...], когда содержимое PDF должно вести себя как рисунок: быть плавающим объектом, иметь подпись и упоминаться в тексте. Используйте \includepdf, когда страницы должны стоять отдельно в полном размере. Частая ошибка — использовать pdfpages для диаграммы: получается целая страница без подписи и без ссылки, на которую нельзя сослаться через \ref. Если читатель когда-нибудь увидит «см. рисунок 3», этому место в окружении figure.