During the Zurich QGIS hackfest we had some extended discussions about migrating our documentation away from LaTeX to sphinx because the latter offers a more approachable syntax for casual documentation writers and has good support for internationalisation via gettext. This week I am going to our first 2012 QGIS hackfest (to be held in Lyon,... Read more »
This post summarizes how to install sphinx on Windows to contribute to PyQGIS Cookbook. I’m writing this as I go, so this most likely won’t be perfect.
I used my Python 2.6 stand-alone installation (not the one in OSGeo4W).
- Get the Sphinx egg from http://pypi.python.org/pypi/Sphinx
- If you don’t have it, install setuptools to get the easy_install script http://pypi.python.org/pypi/setuptools
- In C:\Python26\Scripts run
easy_install -U sphinx
- Get the PyQGIS source from https://github.com/qgis/QGIS-Developer-Cookbook
- Create a build folder inside the QGIS-Developer-Cookbook
- Now you can build the Cookbook:
sphinx-build "C:\Users\Anita\QGIS\QGIS-Developer-Cookbook\source" "C:\Users\Anita\QGIS\QGIS-Developer-Cookbook\build"
The build folder should now contain the Cookbook .html files.