中科大就业怎么样:technical:Sphinx under osx

来源:百度文库 编辑:偶看新闻 时间:2024/05/01 13:38:01
technical:Sphinx under osx

注意本文主要解决Sphinx输出中文PDF问题. html和epub在此配置下都正常运行.

获取最新的Sphinx源代码

hg clone https://bitbucket.org/birkenfeld/sphinx

该版本支持使用pyramid的theme.

安装mactex

下载站点 http://www.tug.org/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的输出文件