Блог

В моем проекте документации Sphinx я использую изображения, подобные этому:

 .. image:: /_static/carousel_filling.png
   :width: 300px
   :height: 450px
   :scale: 100 %
   :alt: Image here
   :align: right
  

В сгенерированных Sphinx HTML docs изображения отлично отображаются на HTML-страницах. Однако, когда я создаю документы PDF с помощью make latexpdf , я выдаю следующую ошибку:

 'LaTeX Warning: File `{carousel_filling}.png' not found on input line ...'
  

Я попытался найти документацию, связанную с выводом изображений, однако я нашел только это:

Выдержки из:

latex_additional_files Список имен файлов, относящихся к каталогу конфигурации, для копирования в каталог сборки при сборке выходных данных LaTeX. Это полезно для копирования файлов, которые Sphinx не копирует автоматически, например, если на них есть ссылки в пользовательском LaTeX, добавленном в latex_elements. Файлы изображений, на которые есть ссылки в исходных файлах (например, через .. image::), копируются автоматически.

Итак, в соответствии с этим файлы изображений должны автоматически добавляться в выходной PDF-файл. Но этого не происходит. В файле pdf, где должно быть изображение, виден только пустой прямоугольник.

Интересно, я вижу, что файл изображения был скопирован в папку _build / latex, так что это означает, что pdflatex есть возможность доступа к файлу изображения !!

Вопрос

Как мне правильно вывести изображения, включенные в мою документацию Sphinx, в сгенерированный PDF-файл?

Редактировать 1:

В терминале я вижу следующее предупреждение:

 LaTeX Warning: File `{carousel_filling}.png' not found on input line 931.

! Package pdftex.def Error: File `"""{carousel_filling}".png' not found: using dra
ft setting.

See the pdftex.def package documentation for explanation.
Type  H <return>  for immediate help.
 ...                                              
                                                  
l.931 ...t=450sphinxpxdimen]{{carousel_filling}.png}
                                                  
? 
[21]
  

Редактировать 2:

Вместо изображения (где контур прямоугольника был выведен в PDF-файл) Я вижу это:

"""{carousel_filling}".png

Не размещайте свои изображения под _static . Это папка специального назначения, не для изображений. Например. создайте img/ на уровне ваших первых файлов, переместите туда изображение и .. image:: img/my-image.png .