Python docutils文档编译过程方法解析
作者:ymh 发布时间:2023-01-20 16:41:23
docutils 的官方工具地址为:https://docutils.sourceforge.io/
目前的更新主要是在版本和使用手册的更新上,因为 Python 使用 reStructuredText 文档格式,那么必不可少会用到 docutils 进行文档生成。
例如,我们希望将 https://docutils.sourceforge.io/ 上的文档生成成中文的手册。
首先你需要将 https://docutils.sourceforge.io/ 上面的 SVN 原代码下载到本地。
假设我们的下载目录是:C:\WorkDir\Ossez-Com\Python\Source-Code\docutils
那么你需要在你的 Python 环境中运行 Python 命令:
(base) C:\WorkDir\Ossez-Com\Python\Source-Code\docutils\docutils>python tools/buildhtml.py --config=tools/docutils.conf
你可以指定配置文件,也可以不指定配置文件。
在你的 Python 环境中会有上面的输出。
然后进入目录: C:\WorkDir\Ossez-Com\Python\Source-Code\docutils\docutils\docs\user 查看,你会看到对应 txt 的源文件已经生成为 html 供你浏览了。
单击一个你修改过的文件,然后查看,中文也能够比较好的支持。
这个就是对 docutils 进行文件编辑的方法。你可以直接修改 txt 文件,然后 Python 生成。
来源:http://www.mamicode.com/info-detail-3040667.html


猜你喜欢
- 引言:Flask是Python社区非常流行的一个Web开发框架,本文将尝试将介绍APScheduler应用于Flask之中。1. Flask
- TTS简介TTS(Text To Speech)是一种语音合成技术,可以让机器将输入文本以语音的方式播放出来,实现机器说话的效果。TTS分成
- 本文的OCR当然不是自己从头开发的,是基于百度智能云提供的API(我感觉是百度在中国的人工智能领域值得称赞的一大贡献),其提供的API完全可
- 什么是SQL 指令植入式攻击?在设计或者维护Web网站时,你也许担心它们会受到某些卑鄙用户的恶意攻击。的确,如今的Web网站开发者们针对其站
- logconfig.json{ "version":1, "disable_existing_loggers&
- 最近在作图时需要将输出的图片紧密排布,还要去掉坐标轴,同时设置输出图片大小。要让程序自动将图表保存到文件中,代码为:plt.savefig(
- 就服务器端处理而言,ASP是产生动态Web网页的一种相对较新的技术。动态页意味着什么呢?先暂时不考虑客户端相关功能上的进展,也不讨论客户端脚
- 在运维场景下,我们经常需要在服务器上用正则表达式来匹配IP地址。shell和其它编程语言一样,也可以使用正则分组捕获,不过不能使用 $1或\
- 有需要的人可以参考一下,如果试用过,发现问题,欢迎留言告知,不胜感激。功能介绍:1、若页面无刷新,且第一次传值小于第二次传值或者圆环初始化时
- 本文实例讲述了MySQL查看、创建和删除索引的方法。分享给大家供大家参考。具体如下:1.索引作用在索引列上,除了上面提到的有序查找之外,数据
- 使用[[v]*n]*n遇到的坑今天通过[[v]*n]*n快速创建列表, 当我使用索引修改值时, 本来是打算修改a[0][0]这一个元素的第一
- $forceUpdate()的使用在Vue官方文档中指出,$forceUpdate具有强制刷新的作用。那在vue框架中,如果data中有一个
- 在 Google 搜索结果页面中,将其 Logo 图标右键另存为后可以发现,它并非单纯的
- 1、此api已经关闭https://api.map.baidu.com/highacciploc/v1?qcip=220.181
- 分享一个关于在pytest中,如何将测试用例文件中的变量传递到fixture函数。一、交代应用场景目前组内的项目,在根目录下是有一个conf
- if语句>>通用格式if语句一般形式如下:if <test1>: <statements1>elif &
- 使用sql语句创建和删除约束 约束类型 主键约束(Primary Key constraint) --:要求主键列数据唯一,并且不允许为空。
- 文件下载(遇到的坑)1.要区分下载的内容是什么0.1 图片下载wx.saveImageToPhotosAlbum(Object
- Web应用中大多会提供静态文件服务以便给用户更好的访问体验。静态文件主要包含CSS样式文件,js脚本,图片和字体等。Flask也支持静态文件
- 阅读是在网站中的一个很重要的部分,可以说是网站的核心。网站最终要呈现给用户的就是内容。尤其是文本内容。豆瓣豆瓣前段时间小改了一下,页面拉宽,