Sphinx + Latex Pdf 파일에 이미지 파일을 포함하는 방법

Aug 17 2020

LaTeX와 함께 Sphinx 문서 도구를 사용하여 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('..'))

B. 다음은 디렉토리 트리입니다.

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 / 라텍스 / 폴더 쇼 이미지.

그렇다면 make latexpdf터미널에서 추가 브래킷이 삽입되는 이유는 무엇입니까?

답변

Matt Aug 21 2020 at 07:15

아래에 이미지를 배치하지 마십시오 _static. 이미지가 아닌 특수 목적의 폴더입니다. 예를 들어 생성 modules/execute/img/, 이미지 이동 및 .. image:: img/my-image.png.