Как включить файлы изображений в файлы Sphinx + Latex Pdf
Я использую инструмент документации Sphinx вместе с LaTeX для создания файлов PDF.
При попытке включить изображения в файл pdf во время компиляции возникает следующая ошибка:
LaTeX Warning: File `{img_file}.jpg' not found on input line 920.
! Package pdftex.def Error: File `"""{img_file}".jpg' not found: using dra
ft setting.
See the pdftex.def package documentation for explanation.
Type H <return> for immediate help.
...
l.920 ...phinxincludegraphics{{img_file}.jpg}
}
?
Вот некоторые ключевые переменные среды:
A. В моем conf.py я определил абсолютный путь как:sys.path.insert(0, os.path.abspath('..'))
Б. Это дерево каталогов:
docs/ # (Sphinx) Documentation folder
_build/
_static/
css/
images/
abc.jpg
img_file.jpg <= This image file is in the root ("_static") directory
_templates/
conf.py
index.rst
modules/ <= Folder containing my source (.rst) files
execute/
file_with_image.rst <= I am trying to put the image in this source file
some_other_file.rst
C. Для включения изображения я использую следующее.
.. image:: /_static/img_file.*
D. Я включил graphix в conf.py преамбулу .
Почему я получаю эту ошибку? Что является источником стольких "" "цитат в сообщении об ошибке?
редактировать
При открытии *.texфайла в редакторе Tex вот что показывает фрагмент кода из раздела вставки изображений:
\subsection{Add Image}
\label{\detokenize{modules/aud_execution/add_image_with_image_directive:add-image}}\label{\detokenize{modules/aud_execution/add_image_with_image_directive::doc}}
\sphinxstylestrong{Adding an image}
Example of image usage using “image” directive:
\noindent{\hspace*{\fill}\sphinxincludegraphics{{img_file}.jpg}} % ***
Используя Quick Build, редактор выдает ошибку, как показано ниже:
! Пакет pdftex.def Ошибка: файл `" "" {img_file} ". Jpg 'не найден: ...
Однако, когда фигурные скобки из имени файла изображения {{img_file}.jpg}удаляются и заменяются на (строка с пометкой ***):
\noindent{\hspace*{\fill}\sphinxincludegraphics{img_file.jpg}} % ***
документ успешно компилируется, и изображение можно увидеть в файле pdf.
Если .texфайл сохранен, файл pdf в папке _build / latex / показывает изображение.
Так почему же дополнительные скобки вставляются make latexpdfиз терминала?
Ответы
Не размещайте изображения под _static. Это папка специального назначения, а не для изображений. Например, создать modules/execute/img/, переместить туда изображение и .. image:: img/my-image.png.