码迷,mamicode.com
首页 > 其他好文 > 详细

sphinx PDF 中文

时间:2018-01-15 20:24:22      阅读:191      评论:0      收藏:0      [点我收藏+]

标签:文章   div   poi   ocs   point   bsp   nal   ref   方式   

使用reST撰写文档时,需要分多个文档时,就必须使用sphinx了,sphinx说起来很简单的,但是默认是不是支持中文的。幸好我出生的晚,sphinx现在已经支持xelatex了^_^

安装

除了pandoc那篇文章里写到的要安装的东西,还需要安装如下软件包

sudo apt install latexmk texlive-lang-chinese

 

操作

sphinx-quickstart docs

以上命令会在当前目录的 docs 子目录中创建一大堆文件(如果不指定docs,则在当前文件夹内创建)。如果是英文的话,我们只要执行

make latexpdf

PDF文档就生成了,但是中文需要修改下配置,研究了半天,最简单的方式是

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

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

    fncychap : ‘‘,

    # Additional stuff for the LaTeX preamble.
    #
    preamble: r‘‘‘\usepackage{ctex}
    ‘‘‘,

    # Latex figure (float) alignment
    #
    # ‘figure_align‘: ‘htbp‘,
}

本来也想用xeCJK,不过搞起来有点困难(虽然也能生成PDF),这里只是引用入ctex宏包,然后把fncychap宏包给去掉了,因为它不支持中文,如果加上章节标题就会是“Chapter 1”这种,而不是“第一章”,当然,去掉之后,标题就不那么fancy了,不过那都是latex的事了,我无能为力了!

 

sphinx PDF 中文

标签:文章   div   poi   ocs   point   bsp   nal   ref   方式   

原文地址:https://www.cnblogs.com/windtail/p/8289421.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!