Перейти к содержимому
Topos Uranos
Русский

Длинные документы

Краткое содержание

Этот урок учит делить длинный документ на несколько файлов так, чтобы он не переставал быть единым документом. Он объясняет, почему стоит разделить диссертацию, книгу или коллективный сборник; различает \input, который вставляет файл так, как если бы его текст был написан на этом месте, и \include, который набирает главу на отдельных страницах и с собственным вспомогательным файлом; показывает, как \includeonly компилирует лишь некоторые главы, сохраняя нумерацию и ссылки, и при каком условии это удаётся; предлагает организацию папок и имён файлов; учит назначать в Texmaker главный документ и всегда компилировать из основного файла; знакомит с пакетом subfiles, позволяющим компилировать главу отдельно; разбирает как полный пример структуру диссертации; и рассматривает самые частые ошибки с их настоящими сообщениями.

Цели обучения

  1. Решать для каждой части длинного документа, вставлять ли её командой \input или командой \include, исходя из их действия на страницы и на вспомогательные файлы.
  2. Предсказывать, какие номера, страницы и ссылки даёт \includeonly, и объяснять, от какой предыдущей компиляции зависит их сохранение.
  3. Организовывать проект в виде основного файла и папок, с путями относительно основного файла и с именами файлов, которые не создают трудностей.
  4. Настраивать Texmaker так, чтобы он компилировал главный документ из любого файла проекта, и готовить с помощью subfiles главы, которые компилируются и по отдельности.
  5. Распознавать в журнале ошибки, присущие разделённым документам, и отличать те, что останавливают компиляцию, от тех, что дают ей завершиться с неполным результатом.

Зачем делить документ

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

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

Для вставки части есть две команды, \input и \include, и разница между ними не стилистическая: каждая делает со страницами и вспомогательными файлами нечто своё.