sfepy/sfepy — Issue #121:  make html
Author: rc
Created: 2012-01-30 10:26:43+00:00
State: open

make html
LANG=C sphinx-build -b html -d _build/doctrees . _build/html
/home/nwagner/local/bin/sphinx-build:5: UserWarning: Module pkg_resources
was already imported from
/home/nwagner/local/lib64/python2.6/site-packages/setuptools-0.6c9-py2.6.egg/pkg_resources.py,
but
/home/nwagner/local/lib64/python2.6/site-packages/distribute-0.6.4-py2.6.egg is
being added to sys.path
from pkg_resources import load_entry_point
/home/nwagner/local/bin/sphinx-build:5: UserWarning: Module site was
already imported from /usr/lib64/python2.6/site.pyc, but
/home/nwagner/local/lib64/python2.6/site-packages/distribute-0.6.4-py2.6.egg is
being added to sys.path
from pkg_resources import load_entry_point
Running Sphinx v1.0

Exception occurred:
File "/home/nwagner/git/sfepy/script/config.py", line 164, in numpydoc_path
raise ValueError(msg_numpydoc)
ValueError: could not find numpydoc!
If it is installed in a non-standard location, try setting it in
site_cfg.py manually.
The full traceback has been saved in /tmp/sphinx-err-CWVqfD.log, if you
want to report the issue to the author.
Please also report this if it was a user error, so that a better error
message can be provided next time.
Send reports to sphinx-dev@googlegroups.com. Thanks!
make: *** [html] Fehler 1

BTW, I can build the documentation for numpy, scipy, matplotlib without
problems.

Migrated from http://code.google.com/p/sfepy/issues/detail?id=119

earlier comments

robert.cimrman said, at 2010-04-21T07:24:03.000Z:

Can you import numpydoc in python or ipython?

The message speaks about site_cfg.py in the sfepy directory - I have there, for example:

numpydoc_path = '/home/share/software/usr/lib64/python2.6/site-packages/numpydoc/

as I installed numpydoc manually as a regular user (not system-wide).

What happens if you set the correct path in site_cfg.py?

logan.sorenson said, at 2010-04-21T13:21:33.000Z:

Hi,

For my case, I have installed numpydoc through easy_install so it is in my
/usr/lib/python2.x/site-packages. If I remember correctly, the numpy/scipy/matplotlib
may include the numpydoc extension in their source packages.

nils106 said, at 2010-04-22T19:19:43.000Z:

I cannot import numpydoc from python.
However I found numpydoc.py in numpy/doc/sphinxext.

How can I install numpydoc via svn ?

logan.sorenson said, at 2010-04-22T19:40:39.000Z:

Hi Nils,

I guess you can do:

svn co http://svn.scipy.org/svn/numpy/trunk/doc/sphinxext numpydoc
export PYTHONPATH=/path/to/numpydoc

before running make html. If you wanted it to be more permanent, you could modify
sys.path in conf.py in the sfepy doc directory to point to the numpydoc location.

logan.sorenson said, at 2010-04-22T19:42:03.000Z:

Oops, probably it is better to modify site_cfg.py in the sfepy as Robert has
suggested above.

robert.cimrman said, at 2010-04-23T07:03:44.000Z:

...or just grab the numpydoc tarball at pypi:

http://pypi.python.org/pypi/numpydoc/0.3.1

unpack it somewhere, and add the path to it to site_cfg.py

freevryheid said, at 2010-04-27T01:47:56.000Z:

latex also needed for make html - Documentation should be updated accordingly.

robert.cimrman said, at 2010-04-27T07:56:00.000Z:

Good point! I will update the docs.

nils106 said, at 2010-04-27T17:28:32.000Z:

I unpacked http://pypi.python.org/pypi/numpydoc/0.3.1 to /home/nwagner/src
and added

numpydoc_path = '/home/nwagner/src/numpydoc-0.3.1'

to site_cfg.py in /home/nwagner/git/sfepy.

It doesn't work.
make html
LANG=C sphinx-build -b html -d _build/doctrees . _build/html
/home/nwagner/local/bin/sphinx-build:5: UserWarning: Module pkg_resources was already
imported from
/home/nwagner/local/lib64/python2.6/site-packages/setuptools-0.6c9-py2.6.egg/pkg_resources.py,
but /home/nwagner/local/lib64/python2.6/site-packages/distribute-0.6.4-py2.6.egg is
being added to sys.path
from pkg_resources import load_entry_point
/home/nwagner/local/bin/sphinx-build:5: UserWarning: Module site was already imported
from /usr/lib64/python2.6/site.pyc, but
/home/nwagner/local/lib64/python2.6/site-packages/distribute-0.6.4-py2.6.egg is being
added to sys.path
from pkg_resources import load_entry_point
Running Sphinx v1.0

Exception occurred:
File "/home/nwagner/git/sfepy/script/config.py", line 164, in numpydoc_path
raise ValueError(msg_numpydoc)
ValueError: could not find numpydoc!
If it is installed in a non-standard location, try setting it in
site_cfg.py manually.
The full traceback has been saved in /tmp/sphinx-err-5MRZJJ.log, if you want to
report the issue to the author.
Please also report this if it was a user error, so that a better error message can be
provided next time.
Send reports to sphinx-dev@googlegroups.com. Thanks!
make: *** [html] Fehler 1

robert.cimrman said, at 2010-04-28T07:03:33.000Z:

Exactly the same steps work for me:

PYTHONPATH=.. sphinx-build -b html -d _build/doctrees . _build/html
Running Sphinx v0.6.5
loading pickled environment... done
building [html]: targets for 1 source files that are out of date
updating environment: 0 added, 2 changed, 0 removed
reading sources... [100%] terms_overview
looking for now-outdated files... none found
pickling environment... done
...

As you can see, I am running Sphinx v0.6.5 - could this be the problem? I did not
know v1.0 already existed.

Also, do you have the latest git version of sfepy? There was some problem in 2010.1...

robert.cimrman said, at 2010-12-03T13:19:26.000Z:

We now use sphinx 1.0.5, so this should be ok.