To build the geotools “doc” folder you will need to install the components of the sphinx documentation system.
Python version 2.7 has been verified to work: http://www.python.org/download/releases/2.7/
You will need to add it to your path.:
set 'PYTHON=C:\Python27\' set 'PATH=%PATH%;%PYTHON%'
You will need Setup Tools for Python 2.7
Install and add Setup Tools to your path:
run 'set SETUPTOOLS=C:\Python27\Scripts' run 'set PATH=%PATH%;%SETUPTOOLS%'
Optionally you could install a specific version of sphinx (although we try and use the latest):
You can optionally install rst2pdf to build pdf documentation:
Install Visual Studio 2008 Express Edition (this provides windows with a C compiler). It is a free download on the Microsoft site. You need to be sure to use the 2008 edition so that easy_install will compile something that can actually be linked to the Python executable.
Use easy install to produce rst2pdf:
This depends on the Python Image Library (which it can probably build now that you have a compiler).
If you cannot manage to build you can download a precompiled Python Image Library (PIL) from here:
You can use the distribution manager of your choice (example bru, macports, etc...). The following example is for macports.
On OSX Use macports to install Python 2.7:
sudo port install python27 sudo port install python_select sudo python_select python27
You can use macports to install Python Image Library:
sudo port install py27-pil
You can now use python easy_install to install sphinx:
sudo easy_install sphinx
Optionally you could ask for a specific version (we try and use the latest):
sudo easy_install sphinx==1.0.7
To build the PDF targets you will also need rst2pdf.:
sudo easy_install rst2pdf
If you uses easy_install to grab the python image library it easy to get compile errors.
Use apt-get and easy install.
Python is usually available by default, if not:
apt-get install Python
You may need to use sudo (if for example you are on unbuntu)
Use easy_install to graph sphinx (using sudo if required):
Optionally you can install a specifc version:easy_install sphinx==1.0.7