python sphinx make html方法（rst格式轉html）

從GITHUB上下載的python文檔有rst格式沒法打開，通常有README.txt裏說明要轉換爲html。原文：

You need Sphinx to build this documentation. Or you can read it in ASCII. ;)

Better run:

# pip install sphinx

and once Sphinx is installed on your system, run:

$ make html

To build a copy of HTML'ed PySNMP documentation.

轉換方法：

以pysnmp爲例，GitHub下載的pysnmp-master文件，查看pysnmp-master\docs下，都是rst格式。如今咱們須要轉換爲html

1.下載sphinx

pip install sphinx

2.使用sphinx轉換html

1. 將pysnmp-master.zip解壓到你須要放置的目錄，我這裏D:\Pythonwork\pysnmp-master

2. 找到source目錄的所在目錄，打開cmd，進入source目錄的上級目錄（我這裏source目錄在D:\Pythonwork\pysnmp-master\docs下），CD D:\Pythonwork\pysnmp-master\docs

3. 執行轉換命令sphinx-build -b html 源目錄 目標目錄，源目錄必須選擇source目錄我這裏由於已經進入了當前source的上級目錄，所以不須要絕對路徑，個人目標目錄設置爲html

   sphinx-build -b html source D:\Pythonwork\pysnmp-master\docs\html 
   

   完成

4. 打開目標目錄找到html文件，完美。