Файли в реальному проекті

Відкрийте папку будь-якого реального проекту LaTeX після компіляції, і ви знайдете набагато більше файлів, ніж ви написали. Це дивує більшість початківців, а страх видалити не те, що потрібно, назавжди залишає папки безладними. Відмінність, яка прояснює це: деякі файли є джерелом, яке ви редагуєте, деякі є стилями, що надаються шаблоном або пакетом, а решта є згенерованим тимчасовим простором, який компілятор відтворює під час кожного запуску.

Файли, які ви пишете

Ваші файли .tex містять фактичний документ: текст, розділи, малюнки та математику. Файл .bib — це ваша база даних бібліографії, по одному запису на статтю чи книгу, яку ви можете цитувати; ви можете підтримувати його вручну або експортувати з довідкового менеджера, як-от Zotero. Це ті файли, які варто створити резервну копію та ввести в контроль версій, тому що все інше можна перебудувати з них.

Файли, надані шаблоном

Файл .cls визначає клас документа, який ви називаєте в \documentclass{...}. Журнали та конференції надсилаються окремо, тож кожна публікація виглядає ідентично, і ви майже ніколи не редагуєте її. Файл .sty — це пакет: багаторазові макроси та налаштування, завантажені за допомогою \usepackage. Ви напишете один самостійно, якщо захочете поділитися спеціальними командами в кількох документах. Файл .bst описує стиль цитування BibTeX і також зазвичай просто завантажується на місці.

Файли, створені компілятором

Файл .aux зберігає перехресні посилання та дані цитування між проходами компіляції; ніколи не редагуйте його та сміливо видаляйте, оскільки наступна компіляція переписує його. Файл .log записує все, що зробив компілятор, і його варто відкривати лише тоді, коли щось піде не так. .pdf - це результат, який ви насправді хотіли.

Макет проекту, який масштабується

paper/
 main.tex
 chapters/
 figures/
 refs.bib

Один main.tex на верхньому рівні діє як точка входу, розділи живуть у власній папці та підтягуються за допомогою \input або \include, зображення знаходяться в figures/, а бібліографія залишається в одному refs.bib. Цей макет залишається керованим незалежно від того, чи є проект чотиристорінковим документом чи дипломною роботою. Розділити файли розділів показує, як частини з’єднуються.

Якщо ви використовуєте Git, додайте *.aux, *.log та інші згенеровані файли до .gitignore, щоб ваша історія відстежувала лише справжнє джерело. Проекти Oleafly — це звичайні папки на диску, тож ця порада актуальна там без змін. Найпоширенішою помилкою є зворотний: під час полювання на дивну помилку компіляції видалення файлів .aux часто є виправленням, оскільки застарілий файл зі зламаного запуску може отруїти кожну компіляцію після нього.