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

.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 часто і є розв’язком, бо застарілий файл після невдалого запуску може отруїти кожну наступну компіляцію.

Назад до Відкрийте петлю