Файлы в реальном проекте

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