用Sphinx生成中文PDF

来自: 询问sphinx + latex 的用法 - ECUG~erlang中文用户组 | Google Groups

第一步: 编译为latex

      make latex

sphinx 自动将reST 文件编译为latex 文件;目标文件在 _build/latex 目录中

第二步:编译为pdf

容是对的,只是IDE 显示问题(可以通过选项看到正常文字);在文档的第二行

      documentclass[letterpaper,10pt,english]{manual}

文件保存在_build/latex 目录下。文件名和前面的latex 文件同名。

     小贴士:每次生成,文档封面上的编写日期都会自动更新,非常方便。

第三步:检查和调整

话,可能输出文档和预想的有差异。另外也需要对于图片通过scale 进行微调,让其大小看起来更加美观。 通读生成的pdf文档,将其中不理想的地方,以及错别字等修订后,再次生成。再检查,直到满意。

多,写写就熟了。虽然在所见即所得方面有损失,但是通过sphinx 我们可以进行团队化的文档编写,可以逐 步修正,片段修改,让文档总是保持最新状态,所有文档都有相同的look and feel。其带来的好处也是非常 大的。熟悉之后,其实一次成功的情况也很多。

讨论

为什么 每次都要 修 改ctexbookutf8 来生 成pdf 文件

   latex_documents = [
           (’index’, ’project-management.tex’, u’唯智项目管理规范(V1.0)’,
           u’vtradex’, ’manual’),

最后一位manual 表明了按照何种格式编译rst 文件;

进 一步 控制

# 控制纸张大小
     latex_paper_size = ‘letter’
# 控制字体大小
     latex_font_size = ‘10pt’

TODO


反馈

创建 by -- ZoomQuiet [2009-12-31 02:55:10]

UsageSphinxExPdf (last edited 2009-12-31 03:17:16 by ZoomQuiet)