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*

Reply via email to