Файлы в настоящем проекте

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

Вернуться к Открыть цикл