Mac 10.8 下安裝Sphinx並支持生成中文PDF

Mac 10.8 下安裝Sphinx並支持生成中文PDF

最近一直在用Sphinx撰寫文檔，可是生成中文PDF時總是失敗。今天在網上查了些資料，終於把它弄成功了。現記錄以下。

須要用到的軟件有：

• python 2.7
• Sphinx 1.2
• MacTex 2013

安裝Sphinx

$ sudo easy_install-2.7 Sphinx

安裝MacTex

請到 http://www.tug.org/mactex/ 下載，或 點此 下載。安裝過程就略了。

讓Sphinx latex支持中文

首先使用 sphinx-quickstart 生成Sphinx項目。而後修改 conf.py 文件。將以下段：

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

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

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

替換成：

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

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

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

# Additional stuff for the LaTeX preamble.
'preamble': '''
\usepackage{xeCJK}
\usepackage{indentfirst}
\setlength{\parindent}{2em}
\setCJKmainfont[BoldFont=SimHei, ItalicFont=STKaiti]{SimSun}
\setCJKmonofont[Scale=0.9]{Consolas}
\setCJKfamilyfont{song}[BoldFont=SimSun]{SimSun}
\setCJKfamilyfont{sf}[BoldFont=SimSun]{SimSun}
'''
}

這些配置的具體含意我也不大清楚，不過自已修改下字體仍是可行的。你能夠使用 fc-list :lang=zh-cn 查看系統所中文字體名字。Mac默認沒有此 fc-list 程序，能夠使用brew安裝。

$ brew install fontconfig

生成PDF

首先你須要在Sphinx項目目錄執行 make latex 命令生成latex，再使用 xelatex *.tex 生成PDF文件。具體步驟以下：

$ make latex
$ cd build/latex
$ xelatex *.tex
$ open *.pdf

結束

好了，如今享受Sphinx撰寫文檔的愉快心情吧！