注意本文主要解决Sphinx输出中文PDF问题. html和epub在此配置下都正常运行.
获取最新的Sphinx源代码
hg clone https:///birkenfeld/sphinx
该版本支持使用pyramid的theme.
安装mactex
下载站点 http://www./mactex/
新建项目
sphinx-quickstart
注意所有字段不应有中文字符否则生成PDF会失败
修改conf.py
latex_preamble = '''\usepackage{xunicode}
\usepackage{xltxtra}
\usepackage{verbatim}
\usepackage{fontspec}
\setromanfont[Mapping=tex-text]{STHeiti}
\setsansfont[Mapping=tex-text]{STHeiti}
\setmonofont[Mapping=tex-text]{Monaco}
\XeTeXlinebreaklocale "zh"
\XeTeXlinebreakskip = 0pt plus 1pt
'''
或者
latex_preamble = '''\usepackage{xeCJK}
\defaultfontfeatures{Mapping=tex-text}
\setCJKmainfont{Hiragino Sans GB}
\setCJKmonofont[Scale=0.9]{Monaco}
\setCJKfamilyfont{song}{Hiragino Sans GB}
\setCJKfamilyfont{sf}{Hiragino Sans GB}
'''
生成 latex
make latex
进入build/latex目录, 生成pdf
xelatex filename.tex
如果成功运行, 则可在目录下看到filename.pdf的输出文件