rst格式文件转换成html格式文件

本文介绍了在Windows系统中使用Python、SetupTools、Sphinx和sphinx_rtd_theme将reStructuredText (rst) 文件转换为HTML的步骤。包括安装Python、SetupTools和Sphinx,配置环境,安装sphinx_rtd_theme,设置文档目录结构,最后通过sphinx-build命令编译生成HTML文件。
摘要由CSDN通过智能技术生成

本次只涉及到windows中将rst文件转成html文件。

1、首先,我们需要保证你的机器上安装了python,我装的是python2.7,可以去官网上进行下载。

2、下载Python包SetupTools

检查Python目录下的子目录Scripts是否存在easy_install.exe文件,如果存在请继续第三步,不存在请下载https://pypi.python.org/pypi/setuptools zip包,解压后放到Python安装的根文件夹下面,并该目录加入到环境变量中。

3、安装Sphinx

启动CMD,并运行命令”easy_install sphinx”,该过程需要一段时间,安装过程中如果出现warning并且安装等待时间过长(一般不超过三分钟),可以按键盘的任意键,继续运行,直到安装完成。

4、安装sphinx_rtd_theme

在cmd中运行“pip install sphinx_rtd_theme”,安装相应的模块。(如果你已经安装可以忽略这一步)。

5、准备rst文档及相关目录

目录结构包含如下,其中docs文件夹包含rst文件。Conf.py存放sphinx-build命令的相关参数,可以根据模板自己文档内容进行修改。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值