\graphicspath

Синопсис:

\graphicspath{list of directories inside curly braces}

Объявляет список каталогов для поиска графических файлов. Это позволяет вам в дальнейшем указать что-то вроде \includegraphics{lion.png} вместо того, чтобы указывать его путь.

LaTeX всегда сначала ищет графические файлы в текущем каталоге (и каталоге вывода, если он задан; см. каталог вывода). Нижеприведенное объявление сообщает системе, что затем необходимо искать в подкаталоге pix, а затем ../pix.

\usepackage{graphicx}   % or graphics; put in preamble
  ...
\graphicspath{ {pix/} {../pix/} }

Объявление \graphicspath является необязательным. Если вы его не включите, по умолчанию LaTeX будет искать во всех местах, где он обычно ищет файл (он использует механизм поиска LaTeX \input@path). В частности, в этом случае одним из мест, где он ищет, является текущий каталог.

Заключите каждое имя каталога в фигурные скобки; например, выше говорится «{pix}». Делайте это даже если каталог только один. Каждое имя каталога должно заканчиваться обратной косой чертой, /. Это верно даже в Windows, где хорошей практикой является использование обратных косых черт для всех разделителей каталогов, так как это делает документ портативным для других платформ. Если в имени каталога есть пробелы, используйте двойные кавычки, как в {"my docs/"}. Если вы нарушите одно из этих правил, LaTeX сообщит Error: File `filename' not found.

В принципе, алгоритм в этом примере таков, что после поиска в текущем каталоге

\graphicspath{ {pix/} {../pix/} }
...
\usepackage{lion.png}

для каждого из указанных каталогов LaTeX конкатенирует его с именем файла и ищет результат, проверяя pix/lion.png и затем ../pix/lion.png. Этот алгоритм означает, что команда \graphicspath не осуществляет рекурсивный поиск подкаталогов: если вы используете \graphicspath{{a/}} , а графический файл находится в a/b/lion.png, LaTeX не найдет его. Это также означает, что вы можете использовать абсолютные пути, такие как \graphicspath{{/home/jim/logos/}} или \graphicspath{{C:/Users/Albert/Pictures/}}. Однако использование таких путей делает документ не портативным. (Портативность можно сохранить, настроив параметр файла конфигурации вашей системы TeX TEXINPUTS; см. документацию вашей системы.)

Вы можете использовать \graphicspath в любом месте документа. Вы можете использовать его более одного раза. Покажите его значение с помощью \makeatletter\typeout{\Ginput@path}\makeatother.

Каталоги берутся относительно базового файла. То есть, предположим, что вы работаете с документом, основанным на book/book.tex, и он содержит \include{chapters/chap1}. Если в chap1.tex вы поместите \graphicspath{{plots/}} , LaTeX не будет искать графики в book/chapters/plots, а вместо этого в book/plots.