使用Sphinx搭建本地(window)文档并把它部署到网上(github)-本地搭建(1)

操作

准备环境

1. 安装python(link)注意安装的时候选择pip
2. 安装Sphinx，两种方法link
   2.1 直接使用命令行(Ctrl+R)

   pip install -U sphinx
   

   2.2 或者用git下载再安装

   pip install git+https://github.com/sphinx-doc/sphinx
   

搭建工程

1. 进入某个目录底下执行命令行,第二个选择我空格了，填完项目名和作者，直接回车

    sphinx-quickstart
   

   
   1.1 选择md格式，默认是rst文件(更新:还是使用rst就好,md和rst可以共用，见文档)