[SciPy-Dev] [GSOC 2018 Project Thread]: Rotation formalism in 3 dimensions

[Lars G.]

On 24.04.2018 20:36, Aditya Bharti wrote:
> Regarding building the documentation, I was able to figure out that I
> needed to install sphinx separately. The HACKING.rst.txt file only
> mentions Numpy Cython and pytest as dependencies.
> I was able to get the make command running with `make html PYVER=3.5`,
> but I'm getting the follwing error:
>  
> 
>     Could not import extension numpydoc (exception: cannot import name
>     'Directive')

Hello Aditya,

I had the same problem with my setup. I'm still a little bit confused
but I think the error was due to an old version of numpydoc trying use
an import that didn't work with new versions of sphinx.
I think got the old version with the git-submodules included in the
doc-dirctory (can be downloaded with `git submodule update`).

Anyway I got it to work by modifying the faulty import itself. Try to
find the file numpydoc/numpydoc.py and try to find the line:

    from sphinx.util.compat import Directive

If you can find that line you may be in luck because replacing that line
with:

    from docutils.parsers.rst import Directive

fixed it for me. I hope this helps.

By the way, perhaps it would be useful to extend the doc/README.txt with
a more thorough explanation of the build process and mention that the
submodules can be downloaded with `git submodule update`. I only found
out because I looked at guide for NumPy
https://github.com/numpy/numpy/blob/master/doc/source/docs/howto_build_docs.rst
while trying to figure out the build process myself.

Best regards,
Lars