位置: 编程技术 - 正文

使用rst2pdf实现将sphinx生成PDF(rst.open)

编辑:rootadmin

推荐整理分享使用rst2pdf实现将sphinx生成PDF(rst.open),希望有所帮助,仅作参考,欢迎阅读内容。

文章相关热门搜索词:rsf教程,rsem使用,rsf教程,rstp命令,rsf教程,rstp命令,rst字段,rsrp pdf图,内容如对您有帮助,希望把文章链接给更多的朋友!

当初项目文档是用sphinx写的,一套rst下来make html得到一整个漂亮的在线文档。现在想要将文档导出为离线的handbook pdf,于是找到了rst2pdf这个项目,作为sphinx的拓展,然后加上少量配置即可输出中文PDF。

rst2pdf

简介

rst2pdf是一个将 reStructuredText 转换为 PDF 的工具,具有下列特性:

自定义页面布局 支持层叠样式表 支持内嵌TTF和Type1字体 支持几乎所有语言的语法高亮 使用reStructuredText作为源文件 支持字间距调整

安装

配置rst2pdf

注册到sphinx项目

需要告诉sphinx我们安装了rst2pdf,并且将其作为插件使用。只需在项目根目录下的conf.py中配置:

即可。然后,在conf.py中拷入PDF相关的配置:

具体配置项的值请自行调整,不需要严格按照我的来。

样式表

在项目根目录下创建一个zh_CN.json,写入:

关于以上样式的说明:

embeddedFonts用于嵌入字体,经试验,必须包含至少四个值才不会报错。不过这四个字体值可以是重复的。

fontsAlias用来指定各类字形用什么字体。如stdFont指正文字体,stdBold指粗体,stdItalic指斜体。其他的还有stdBoldItalic粗斜体,stdMono等宽体,等等。确保所用字体已经安装在你的操作系统上,且字体必须是TTF类型的(Windows环境下限制比较多~)。

wordWrap用于指定换行规则,CJK就是适用于中日韩文字的规则。这是从网上的模板抄来的,但经我的测试发现,如果用CJK规则的话,中英混排的文档里面英文部分就没法正常断行,这真是个遗憾。实际上,fontsAlias的分类很多都只对英文字体有意义,如严格来讲中文是没有所谓斜体的(不过因为Word的普及,经常看到中文被设置为斜体的情形)。如果是纯中文文档,当然随便用哪些中文字体都行,如宋体。现实中,经常会有中英文混排的情形,所以如果全用中文字体的话,英文部分就没法显示斜体等字形了。

关于pdf_stylesheets的说明:这个参数中默认使用的某些样式包含了一些字体,而这些字体并非在所有操作系统上都找得到。'sphinx'和'kerning'都是默认提供的样式,要么不用它们,要么直接修改其包含的字体。'a4'指设置输出的PDF为A4纸大小。默认的样式文件可以在rst2pdf的安装路径下找到。

然后配置编译脚本

使用rst2pdf实现将sphinx生成PDF(rst.open)

Windows用户,在make.bat中加入:

类Unix用户修改Makefile:

输出PDF

然后一句:

就能输出PDF了。

解决findfonts.py: Unknown font:

这应该是由于pdf_font_path配置有误造成的,事实上,我确定配置无误rst2pdf还是找不到字体文件,于是我修改了X:Program Files (x)PythonLibsite-packagesrst2pdffindfonts.py第行,在

fontfile = get_nt_fname(fname)

后面加了一句:

fontfile = 'C:\Windows\Fonts\simsun.ttc'

强行解决问题。

解决rst2pdf输出PDF为空白文档

事实上,在字体正常的情况下,我发现输出的PDF依然是空白的:

在使用二分法排除rst文件中的问题后,我发现这是由于PDF开头的目录造成的。当目录超出一页时就会发生这种情况,我倾向于认为这是rst2pdf的一个bug。

解决方法是将pdf_toc_depth调小一点,或者干脆不生成目录,pdf_use_toc = False。

PDF效果

于是再次重试,可以生成漂亮的PDF了:

相关链接:

python多线程方式执行多个bat代码 python多线程方式执行多个bat的代码,感兴趣的朋友可以参考下。importthreadingfromwinapiimport*classMyThread(threading.Thread):def__init__(self,bat_path,**kwargs):threading.Thre

python实现多线程的方式及多条命令并发执行 一、概念介绍Thread是threading模块中最重要的类之一,可以使用它来创建线程。有两种方式来创建线程:一种是通过继承Thread类,重写它的run方法;另一

python3批量删除豆瓣分组下的好友的实现代码 python3批量删除豆瓣分组下的好友的实现代码"""python3批量删除豆瓣分组下的好友年6月7日::codegay我两年前一时冲动在豆瓣关注了很多豆瓣的员工,

标签: rst.open

本文链接地址:https://www.jiuchutong.com/biancheng/387589.html 转载请保留说明!

上一篇:python监控文件或目录变化(python系统监控)

下一篇:python多线程方式执行多个bat代码(多线程 python)

  • 政府补助是否可以抵扣税
  • 合并报表成本法和权益法区别
  • 购进餐饮服务的会计分录
  • 原材料的归集和整理
  • 小规模增值税做那个费用科目
  • 企业纳税成本管理方案
  • 增值税发票抵扣多少个点
  • 承兑汇票的贴现费用怎么计算
  • 差旅费包括哪些明细
  • 印花税账务处理
  • 现金流量表中收入怎么算
  • 利息股息红利个税如何计算
  • 公司买车可以抵什么税
  • 小规模季报财务报表只看季度最后一个月的数据可以吗
  • 差额征税科目
  • 开餐费发票要开具数量和单价吗
  • 自由职业者知乎
  • 售后服务领用材料分录
  • 银行年费计入管理费用还是财务费用
  • 佣金可以开票吗
  • 新会计准则下建筑业会计科目设置
  • win10 21h1正式版怎么样
  • 电脑折旧率计算公式
  • win11咋截屏
  • 公司购买车怎么做
  • 个别报表内部交易
  • 固定资产计提折旧是当月还是次月
  • PHP:mcrypt_list_algorithms()的用法_Mcrypt函数
  • vite vuex
  • 资产负债表中其他流动资产包括哪些科目
  • php 遍历树
  • 成本费用损失的区别和联系
  • css转换器
  • 小程序微信认证
  • 损失函数解读例题
  • 委托代销商品委托方和受托方会计分录
  • php smtp发送邮件
  • 微信公众号的推送
  • 期货收入交个人所得税吗
  • php环境配置教程
  • 小规模所得税怎么计算公式
  • 基于法律行为的物权变动模式包括
  • 设备安装收入税率
  • 股份有限公司个人股份
  • 外购产品捐赠
  • 以摊余成本计量的债权投资与以公允价值计量且其变动
  • sql server数据库连接端口1434
  • 纳税人可以享受六项专项附加扣除
  • 长期借款利息如何计算
  • 记账凭证核算形式
  • 电商平台经销商
  • 买商品赠送赠品怎么做账
  • 股权转让的会计资料归谁所有
  • 代收运输费的会计分录
  • 小规模纳税人销售自己使用过固定资产
  • 直接人工成本项目
  • 劳务外包存在的法律风险
  • 工资计提数小于发放数,如何处理
  • 赠送商品给客户怎么写分录
  • 什么是固定资产清理
  • sql server中Select count(*)和Count(1)的区别和执行方式
  • freebsd常用命令
  • xp系统有什么用
  • 如何修复hosts文件
  • win7系统如何配置ip地址
  • 怎么提升mac性能
  • w10 2021年更新
  • ini文件编辑
  • android自定义属性详解
  • html页面头部
  • linux shell中 if else以及大于、小于、等于逻辑表达式介绍
  • 举例简介三国演义人物塑造的主要手法
  • Android使用opencv处理图片灰度
  • javascript例题
  • 快速解决偏头痛的6个方法
  • python魔法方法有啥用
  • a级纳税人和一级的区别
  • 招投标文件未规定怎么办
  • 我各位一个关于网上申报增值税所得税的申报流
  • 江苏国税发票出库时间
  • 免责声明:网站部分图片文字素材来源于网络,如有侵权,请及时告知,我们会第一时间删除,谢谢! 邮箱:opceo@qq.com

    鄂ICP备2023003026号

    网站地图: 企业信息 工商信息 财税知识 网络常识 编程技术

    友情链接: 武汉网站建设