VScode+Sphinx+ReadTheDocs 从环境搭建到放弃

这篇博客详细记录了在Windows10下使用VScode、Sphinx和ReadTheDocs搭建文档环境的过程,包括Python、Git、VScode及插件的安装,Sphinx项目的创建,以及GitHub和ReadTheDocs的配置。尽管文中提到部分步骤可能对Python新手有挑战,但按照指南操作,可以成功建立文档系统。
摘要由CSDN通过智能技术生成

概述

此篇博客用来记录在windows10中配置环境的过程,注意是Windows下 ,我没有在Linux下面尝试过配置。一下参考了各路教程加上自己亲测,应该是没有问题的。 ……..被掏空(◎_◎;)

目录

材料清单

  • Python 3.4
  • Visual Studio Code
  • Git
  • GitHub仓库
  • GitHub Desktop

工具安装

  1. 安装Python3.4

  2. 安装Git

  3. 安装Visual Studio Code

  4. 安装GitHubDesktop

正确安装完上述软件之后接下来说明具体操作:

打开PowerShell 输入命令:

安装 sphinx

pip install sphinx sphinx-autobuild

安装 restructuredtext-lint

pip install restructuredtext-lint

注:

To Python小白:如果没有正确的将Python添加到环境变量,那么powerShell是不会识别 pip 命令的。我也是个Python小白呵呵呵

VScode配置

  1. 安装插件 reStructuredText

这里写图片描述

它提供了.rst文件的预览功能十分便捷。

  1. 安装插件 Table Formatter

由于reStructuredText做表格特别麻烦&#

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值