Один кореневий файл, багато розділів

include проти input, includeonly і чернетка по одному розділу.

Один кореневий файл, багато розділів

Дисертація в одному файлі .tex стає нестерпною для роботи десь після другого розділу: прокручування замінює мислення, а кожна компіляція обробляє все. Стандартне лікування — один кореневий файл, що містить клас і преамбулу, з кожним розділом у власному файлі. Кореневий файл зшиває їх докупи.

Кореневий файл

% main.tex
\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/methods}
\include{chapters/results}
\end{document}

main.tex — єдиний файл, який ви коли-небудь компілюєте. Кожна команда \include називає інший файл без розширення .tex, із прямими скісними рисками на всіх платформах, і підтягує його вміст саме в цьому місці. Самі файли розділів містять лише вміст, зазвичай починаючи з \chapter{...}. У них немає ні \documentclass, ні власного середовища document, бо вони — фрагменти цього документа, а не окремі документи.

include проти input

Дві команди включення поводяться по-різному, і ці відмінності вирішують, яку де застосовувати. \include починає нову сторінку перед матеріалом, що пасує розділам, і записує окремий файл .aux для кожного підключеного файлу, що й робить можливою вибіркову компіляцію. \input — це проста текстова вставка: без розриву сторінки, без окремого .aux, і її можна вкладати в інший input. Тому \input — правильний інструмент для фрагментів, менших за розділ, як-от велика таблиця у власному файлі чи спільний файл макросів. Одне структурне правило, яке слід пам’ятати: \include не можна вкладати в підключений файл, тоді як \input можна використовувати де завгодно.

Чернетка по одному розділу

\includeonly{chapters/methods}

Поміщена в преамбулу, \includeonly каже LaTeX обробляти лише перелічені файли, водночас зчитуючи збережені дані .aux усіх інших. Компіляція прискорюється разюче, а оскільки мітки й кількості сторінок інших розділів відтворюються з їхніх файлів .aux, перехресні посилання й нумерація в розділі, який ви пишете, лишаються правильними. Ця друга половина і є причиною віддавати перевагу цьому, а не закоментуванню рядків \include, що повністю «забуває» інші розділи й перетворює кожен \ref на них на ??.

Для повних збірок закоментуйте рядок \includeonly і завжди робіть повну компіляцію перед тим, як ділитися PDF, бо застарілі дані .aux можуть відставати від правок, зроблених у виключених розділах. Щоб дізнатися, які файли в отриманій теці ваші, а які згенеровані, див. файли в справжньому проєкті.

Назад до Довга форма