[Sphinx/LaTeX] Sphinx를 사용하여 한글 pdf 문서 만들기

• 만들어진 API 문서를 pdf로 변환하거나 별도의 매뉴얼 문서를 pdf로 만들고자 할 때 Sphinx와 LaTeX를 사용하여 쉽게 만들 수 있다.
• Sphinx를 사용해서 만든 pdf 문서의 예시는 Sphinx 매뉴얼 문서를 참고한다. - https://buildmedia.readthedocs.org/media/pdf/sphinx/stable/sphinx.pdf
• TeX Live와 같은 LaTeX와 한글 글꼴이 미리 설치되어 있어야 한다.

TeX Live, 한글 글꼴 설치

• TeX Live 설치 - http://wiki.ktug.org/wiki/wiki.php/TeX%20Live%20%EC%84%A4%EC%B9%98%20%28Windows%29
• Naver 나눔글꼴 설치 - https://hangeul.naver.com/2017/nanum

conf.py에 설정 추가

# -- Options for LaTeX output ------------------------------------------------
latex_engine = 'xelatex'
latex_elements = {
    # The paper size ('letterpaper' or 'a4paper').
    #
    'papersize': 'a4paper',

    # The font size ('10pt', '11pt' or '12pt').
    #
    'pointsize': '10pt',

    # Additional stuff for the LaTeX preamble.
    #
    'preamble': '',

    # Latex figure (float) alignment
    #
    'figure_align': 'htbp',


    # kotex config
    'figure_align': 'htbp',

    'fontpkg': r'''
\usepackage{kotex}

% 영문 폰트 설정
\setmainfont[Mapping=tex-text]{나눔고딕}
\setsansfont[Mapping=tex-text]{나눔명조}
\setmonofont{나눔고딕코딩}

% 한글 폰트 설정
\setmainhangulfont[Mapping=tex-text]{나눔고딕}
\setsanshangulfont[Mapping=tex-text]{나눔명조}
\setmonohangulfont{나눔고딕코딩}

''',
}

Export pdf

$ make latexpdf