J'ai installé Sphinx dans l'environnement de Mac OS X 10.8.5 + Python 2.7.5. Vous devez être connecté à Internet.
Tout d'abord, téléchargez et installez ez_setup.py. Pour Mac OS X, la commande get est curl au lieu de wget.
$ curl https：//bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py -o ez_setup.py
$ python ez_setup.py
Si l'installation échoue, essayez de l'exécuter avec les privilèges d'administrateur.
$ sudo python ez_setup.py
Installez Sphinx avec le fichier easy_install installé. Cette fois, 1.1.3 a été sélectionné. (Le dernier est 1.2.)
$ easy_install sphinx
Searching for sphinx
Best match： Sphinx 1.1.3
...
Créez un répertoire de projet (ici "sphinx") et déplacez le courant.
$ mkdir sphinx
$ cd sphinx/
Générez un projet Sphinx avec sphinx-quickstart. Puisqu'il s'agit d'un "essai", j'ai répondu aux questions après avoir exécuté sphinx-quickstart avec presque les valeurs initiales (appuyez sur la touche [Entrée]).
$ sphinx-quickstart
$ ls
Makefile build/ make.bat source/
"Index.rst" dans le répertoire source est le fichier reStructuredText.
$ ls source/
_static/ _templates/ conf.py index.rst
Créez du HTML à partir d'un fichier dans le répertoire source.
$ make html
$ ls build/html/
_sources/ genindex.html objects.inv searchindex.js
_static/ index.html search.html
Démarrez le navigateur WWW (Safari dans ce cas) et vérifiez le HTML créé.
$ open /Applications/Safari.app build/html/index.html
Recommended Posts