This post describes how to install sphinx on macOS Sierra version 10.12.6 and methods to verify the installation.
【The steps are listed as follows】
First. Open Terminal.
Press 【Command+Space】 and type 【Terminal】 and press the 【Enter】 key.
Second. Install Homebrew.
Run in Terminal app:
and press the 【Enter】 key.
~Note~
If the screen prompts you to enter a password, enter your Mac’ root password, and press “Enter” key. Then wait for the command to finish.
【ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null】
Third. Install Python 3.
In Terminal app run 【Brew install python】, and press 【Enter】 key.
Fourth. Install Sphinx.
In Terminal run 【pip3 install -U sphinx】, and press 【Enter】 key.
【Verify the installation after each installation】
You can verify if each installation is successful.
· For Homebrew, use 【brew doctor】.
· For Python, use 【python --version】.
· For Sphinx, use 【sphinx-quickstart】.
【Reference】
[4] How to use Sphinx to give an old book new life
[1] http://docs.python-guide.org/en/latest/starting/install3/osx/
[2] https://www.ibm.com/developerworks/cn/opensource/os-sphinx-documentation/
[3]https://technomilk.wordpress.com/2011/04/03/generating-e-books-with-sphinx/
[5] http://www.sphinx-doc.org/en/master/