Файли в справжньому проєкті
.tex, .bib, .cls, .sty і згенероване сміття, яке не варто додавати до репозиторію.
Файли в справжньому проєкті
Відкрийте теку будь-якого справжнього проєкту LaTeX після компіляції, і ви побачите набагато більше файлів, ніж писали самі. Це дивує більшість початківців, а страх видалити не те назавжди лишає теки захаращеними. Розрізнення, яке все прояснює: одні файли — це джерело, яке ви редагуєте, інші — стилі, що постачає шаблон чи пакет, а решта — згенеровані тимчасові файли, які компілятор створює наново під час кожного запуску.
Файли, які пишете ви
Ваші файли .tex містять сам документ: текст, розділи, рисунки й математику. Файл .bib — це база даних вашої бібліографії, один запис на кожну статтю чи книжку, яку ви можете цитувати; його можна вести вручну або експортувати з менеджера бібліографії на кшталт Zotero. Ці файли варто резервувати й тримати в системі контролю версій, бо з них можна відновити все решту.
Файли, які дає шаблон
Файл .cls визначає клас документа, той, що ви вказуєте в \documentclass{...}. Журнали й конференції постачають власні, щоб усі подані роботи виглядали однаково, і ви майже ніколи їх не редагуєте. Файл .sty — це пакет: багаторазові макроси й налаштування, що підключаються через \usepackage. Власноруч ви писатимете його лише тоді, коли захочете ділитися власними командами між кількома документами. Файл .bst описує стиль цитування BibTeX і так само зазвичай просто додається видавцем.
Файли, які створює компілятор
Файл .aux зберігає дані про перехресні посилання й цитування між проходами компіляції; ніколи його не редагуйте й сміливо видаляйте, бо наступна компіляція запише його знову. Файл .log фіксує все, що робив компілятор, і його варто відкривати лише тоді, коли щось іде не так. Файл .pdf — це результат, який ви, власне, й хотіли.
| Розширення | Роль | Редагувати вручну? |
|---|---|---|
.tex | Вихідні документи й розділи | Так |
.bib | База даних бібліографії | Так (або експорт із Zotero) |
.cls | Клас документа | Рідко, шаблони видавців |
.sty | Пакети / файли стилів | Коли пишете власні макроси |
.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 часто і є розв’язком, бо застарілий файл після невдалого запуску може отруїти кожну наступну компіляцію.