откуда рекомендация "one directory per document"?

[longstreet]

Несколько раз встречал рекомендации держать каждый *.tex файл одного документа (когда используется include или input или подобные) в отдельной директории. Сам помню плохо, но вроде бы у меня была когда-то проблема компиляции (то ли из-за перезаписи каких-то вспомогательных $\TeX$ файлов, то ли ещё чего), которая пофиксилась сразу же как я разнёс файлы по отдельным диреткориям.

Действительно ли "one directory per document" -- стоящий совет?

[Red_Herring]

А что Вы называете документом?

Моя точка зрения: каждый проект д.б. в отдельной директории, которая может содержать поддиректории. Если я работаю над документом содержащим отдельные главы, то есть мастер-директория с мастер-тех-файлом, файлом с определениями и библио-файлом и куча поддиректорий отвечающих главам, каждая из которых содержит chapter1.tex и т.д. Поскольку главы у меня (как и следует) через \include, то туда же идут chapter1.aux (автоматически).

В любом случае пользователи, виновные в «свальном грехе», часто имеют проблемы. Особо те, кто участвует в конкурсе «Сколько можно максимально файлов выложить на десктоп».

[longstreet]

Red_Herring в сообщении #1081771 писал(а):

А что Вы называете документом?

Да, ваше слово "проект" куда лучше, его и подразумевал.

Ага, ваша структура директорий понятна, спасибо!

[Lenchik]

Что же плохого может приключиться, если мастер-файл и файлы глав, подключаемые include, будут в одной папке?

По поводу расположения мета-файлов есть разные варианты:
http://tex.stackexchange.com/questions/7265/need-aux-file-in-separate-folder
http://texblog.org/2015/08/20/hiding-latex-metafiles-from-project-directory/

[Red_Herring]

Lenchik в сообщении #1081796 писал(а):

Что же плохого может приключиться, если мастер-файл и файлы глав, подключаемые include, будут в одной папке?

Ничего страшного. Но если глав много, да у глав есть по паре вариантов, то будет достаточно неаккуратно. Не след забывать, что при многих пакетах могут появиться очень многие вспомогательные файлы с разными расширениями.

Что касается aux файлов, то они (как и другие) вспомогательные файлы появляются автоматически. Но, в отличие от других, если chapter1.tex лежит в отдельной директории, то chapter1.aux появится там (а master.aux—там где master.tex, и он будет знать где лежат chapter1.aux и т.д.). Кстати, в главную директорию следует положить и foo.aux, bar.aux и т.д. — при использовании пакетов xr или xr-hyper (для кросс-ссылок) [всё это без специальной output-directory]. Можно использовать разные подходы—главное чтобы сам (и соавторы, или консультанты, если имеются, и "комиссия по научному наследству", если что случится не запутались. И чтобы редакторы не поминали твоего имени вкупе со всеми ругательствами, им известными).

А что такое "страшное" ? Страшное с точки зрения LaTeX? Так LaTeX может часто вытерпеть и «свальный грех», и плохо сформатированный код, и дикие имена файлов вроде V23.tex и бог знает что ещё. А вот пользователь разобраться в этом безобразии по прохождении какого-то времени (не говоря о соавторе) сможет с большим трудом.

[Lenchik]

Что скажете о структуре Russian-Phd-LaTeX-Dissertation-Template?
Там есть проблема совместимости с ShareLaTeX, из-за того, что тот считает, что мастер-файлы должны быть только в корне проекта.
Но плюс такого "свального построения" — то, что в редакторах, типа ТеХСтудио, где можно почистить проект от мета-файлов, чистит сразу текущую папку и тогда проще отслеживать/исправлять ошибки.

[Red_Herring]

Lenchik в сообщении #1082265 писал(а):

Но плюс такого "свального построения" — то, что в редакторах, типа ТеХСтудио, где можно почистить проект от мета-файлов, чистит сразу текущую папку и тогда проще отслеживать/исправлять ошибки.

У меня на Маке чистит всё. Ну и можно с терминала, с использованием * . Что Вы называете мета-файлом? Только aux, или все прочие?

[Lenchik]

aux и все прочие. Большая часть перечислена в http://github.com/github/gitignore/blob/master/TeX.gitignore