Sphinx 匯出中文 PDF

安裝 MacTeX

修改專案目錄下的 conf.py

...

language = 'zh_TW'

...

latex_elements = {
# The paper size ('letterpaper' or 'a4paper').
'papersize': 'a4paper',

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

'classoptions': ',english',
'inputenc': '',
'utf8extra': '',

# Additional stuff for the LaTeX preamble.
'preamble': '''
\usepackage{xeCJK}
\setCJKmainfont[BoldFont=Heiti TC, ItalicFont=STKaiti]{Heiti TC}  % 設定中日韓字型
\setCJKmonofont[Scale=0.8]{Courier New}  % 設定中日韓等寬字型
\XeTeXlinebreaklocale "zh"  % 設定斷行演算法為中文
\XeTeXlinebreakskip = 0pt plus 1pt  % 設定中文字距與英文字距
''',

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

字型可以參考網頁中英文字型(font-family)跨平台設定最佳化或檢視系統已安裝的字型

  $fc-list :lang=zh-tw

匯出 PDF

  $ make latex
  $ cd _build/latex
  $ xelatex *.tex

參考

• 用Python做科學計算 - 關於本書的編寫
• Mac下的Latex中文解決方案: XeTeX
• 網頁中英文字型(font-family)跨平台設定最佳化