Four steps to install sphinx on macOS Sierra version 10.12.6.

in #sphinx7 years ago (edited)

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/