星光尽头

科技与人文的那个交集

M.J

在Mac下使用sphinx生成pdf文档并支持中文

关于Sphinx
==========
Sphinx是一个python写的文档编写工具,使用reStructedText编写文档,可以自动生成html,pdf,latex等多种格式(目前官方不支持doc和docx)。用于写文档非常方便。

安装sphinx需要python 2.7支持,运行如下命令

sudo easy_install-2.7 Sphinx

入门教程可以参考:

http://www.ibm.com/developerworks/cn/opensource/os-sphinx-documentation/

更多信息可以参考官网,需要翻墙访问:

http://sphinx.pocoo.org

 

关于Latex
===========
使用sphinx生成pdf文件需要latex的支持,所以对于mac用户,在这之前需要到MacTeX官网去下载并安装MacTeX。

MacTeX官网:https://tug.org/mactex/

官网上有完整安装包和基础安装包。完整安装包MacTeX.pkg 大约为2.4G(2014版),强烈推荐使用这个,免去更新的麻烦。
如果实在担心浪费空间的话,可以先安装BasicTeX(才200多M),然后缺包时使用tlmger包管理器进行更新(我是一路更新过来的,因为macbook air才128G空间,很容易消耗完,但是没必要为此浪费太多时间),语法如下:

tlmger install {packname}

然后参考这篇文章让sphinx生成的pdf支持中文

http://my.oschina.net/yangbajing/blog/170262

 

最后,在项目目录下使用make latexpdf就能生成pdf文档了。

2015/03/10 0 / /
标签:  暂无标签

8 + 6 =

回到顶部