OK folks this is fixed The further steps I needed were
1) Add the following to ~/.bashrc export PYTHONPATH=$PYTHONPATH:$OCW_HOME:$OCW_HOME/ocw 2) source ~/.bashrc 3) add the following to ~/.bash_profile #virtualenv for ocw alias ocw='source ~/ocw/bin/activate ~/ocw/' 4) enter into the ocw virtualenv e.g. typing 'ocw' in the terminal I can now build the documentation absolutely fine e.g. (/Users/lmcgibbn/ocw)lmcgibbn@LMC-032857 /usr/local/climate(master) $ cd docs && make html sphinx-build -b html -d build/doctrees source build/html Running Sphinx v1.2.1 loading pickled environment... not yet created loading intersphinx inventory from http://docs.python.org/2/objects.inv... loading intersphinx inventory from http://docs.scipy.org/doc/scipy/reference/objects.inv... loading intersphinx inventory from http://docs.scipy.org/doc/numpy/objects.inv... loading intersphinx inventory from http://matplotlib.sourceforge.net/objects.inv... building [html]: targets for 10 source files that are out of date updating environment: 10 added, 0 changed, 0 removed reading sources... [100%] ui-backend/backend /usr/local/climate/docs/source/data_source/data_sources.rst:21: WARNING: autodoc: failed to import module u'esgf'; the following exception was raised: Traceback (most recent call last): File "/Users/lmcgibbn/ocw/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 335, in import_object __import__(self.modname) File "/usr/local/climate/ocw/data_source/esgf.py", line 25, in <module> from ocw.esgf.search import SearchClient File "/usr/local/climate/ocw/esgf/search.py", line 24, in <module> from pyesgf.search import SearchConnection ImportError: No module named pyesgf.search looking for now-outdated files... none found pickling environment... done checking consistency... done preparing documents... done writing output... [100%] ui-backend/backend writing additional files... genindex http-routingtable py-modindex search copying static files... WARNING: html_static_path entry u'/usr/local/climate/docs/source/_static' does not exist done copying extra files... done dumping search index... done dumping object inventory... done build succeeded, 2 warnings. Build finished. The HTML pages are in build/html. BTW the documentation looks fantastic and the recent work done to it gains huge merit and KUDOS. Great job. I really feel that it would be valuable if nightly versions of this documentation were available for people. I am going to try and work towards making this happen. Justification for this is as follows, during the AGU Fall Meeting in December, one thing I learned is that the different modules e.g. Metrics, Plotter, Data Sources, etc can be better communicated to people. By having nightly SNAPSHOT's of this crucial documentation it lowers the barrier to people understanding more about what OCW can do for them. On a final note, I've created the following ticket to address this https://issues.apache.org/jira/browse/CLIMATE-562 Thanks folks Lewis On Mon, Jan 5, 2015 at 9:59 PM, Lewis John Mcgibbney < lewis.mcgibb...@gmail.com> wrote: > Hi Folks, > After getting back a beautifully clean laptop, I tried to build the > climate docs with Running Sphinx v1.2.2 under Python 2.7.8 > > lmcgibbn@LMC-032857 /usr/local/climate(master) $ cd docs && make html > sphinx-build -b html -d build/doctrees source build/html > Making output directory... > Running Sphinx v1.2.2 > > Extension error: > Could not import extension sphinxcontrib.autohttp.bottle (exception: No > module named sphinxcontrib.autohttp.bottle) > make: *** [html] Error 1 > > I partially resolved this by executing > > lmcgibbn@LMC-032857 /usr/local/climate/docs(master) $ pip install > sphinxcontrib-httpdomain > > Then I got > > lmcgibbn@LMC-032857 /usr/local/climate(master) $ cd docs && make html > sphinx-build -b html -d build/doctrees source build/html > Running Sphinx v1.2.2 > loading pickled environment... not yet created > loading intersphinx inventory from http://docs.python.org/2/objects.inv... > loading intersphinx inventory from > http://docs.scipy.org/doc/scipy/reference/objects.inv... > loading intersphinx inventory from > http://docs.scipy.org/doc/numpy/objects.inv... > loading intersphinx inventory from > http://matplotlib.sourceforge.net/objects.inv... > building [html]: targets for 10 source files that are out of date > updating environment: 10 added, 0 changed, 0 removed > reading sources... [100%] ui-backend/backend > Exception occurred: > File > "/usr/local/climate/ocw-ui/backend/local_file_metadata_extractors.py", line > 24, in <module> > from bottle import Bottle, request, route, response > ImportError: No module named bottle > The full traceback has been saved in > /var/folders/xd/mmrnt3jd3hj2k52cb01cqys8001klv/T/sphinx-err-zdzJcN.log, if > you want to report the issue to the developers. > Please also report this if it was a user error, so that a better error > message can be provided next time. > A bug report can be filed in the tracker at < > https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks! > make: *** [html] Error 1 > > After installing bottle > > lmcgibbn@LMC-032857 /usr/local/climate/docs(master) $ pip install bottle > > I got > > lmcgibbn@LMC-032857 /usr/local/climate(master) $ cd docs && make html > sphinx-build -b html -d build/doctrees source build/html > Running Sphinx v1.2.2 > loading pickled environment... not yet created > loading intersphinx inventory from http://docs.python.org/2/objects.inv... > loading intersphinx inventory from > http://docs.scipy.org/doc/scipy/reference/objects.inv... > loading intersphinx inventory from > http://docs.scipy.org/doc/numpy/objects.inv... > loading intersphinx inventory from > http://matplotlib.sourceforge.net/objects.inv... > building [html]: targets for 10 source files that are out of date > updating environment: 10 added, 0 changed, 0 removed > reading sources... [100%] ui-backend/backend > Exception occurred: > File > "/usr/local/climate/ocw-ui/backend/local_file_metadata_extractors.py", line > 26, in <module> > import ocw.utils > ImportError: No module named ocw.utils > The full traceback has been saved in > /var/folders/xd/mmrnt3jd3hj2k52cb01cqys8001klv/T/sphinx-err-j34JMn.log, if > you want to report the issue to the developers. > Please also report this if it was a user error, so that a better error > message can be provided next time. > A bug report can be filed in the tracker at < > https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks! > make: *** [html] Error 1 > > This issue is actually not resolved, but I just wanted to show people some > problem I encountered so that they may get past the dependency management > aspect of building the documentation. Now it would appear that I need to > execute some other prerequisite so have ocw.utils on the Python Path. > I'll follow up here once this is done. > Thanks > LEwis > > > > -- > *Lewis* > -- *Lewis*