最近要整理泰嶽區塊鏈的文章，準備用read the doc來做文章的管理。
裏面使用到sphinx和mkdocs。其實這兩種都可以，sphinx 主要用rst文件，mkdocs主要是對於md文件。來看看我遇到的坑。
Mac sphinx的安裝：
按照read the doc 的步驟：
1、安裝 sphinx；
pip install sphinx
因爲mac自己帶有pip 需要更新一下：
2、安裝pip；。因爲mac自己帶有pip，所以只需要更新一下。
pip install --upgrade pip
安裝的時候你會發現pip是python2.7的版本，但是2.7的版本不維護了，無法使用 
所以要下載最新的3.8版本
python的官網：https://www.python.org/downloads/
3、後面看了read the doc的 sphinx 官方安裝，千萬別安官網安裝，坑太多。
4、安裝好python3後，可以直接下面的命令進行安裝
pip3 install sphinx這樣一下就安裝上了。後面就可以使用。參考read the doc
Mac mkdocs的安裝：
mkdocs的安裝就用別用pip3，需要用pip install mkdocs
剩下的步驟，就用read the doc的指導說明就可以了
另外：網上有一些easy_install -U sphinx 來安裝也是不行的。主要還是python的版本問題。