Citations broken

[prisae]

Since empymod v1.4.2 (Sept. 2017) the citations in the docs are broken; an additional 0 is added to the label, for which reason all subsequent citations in the code are "undefined".

Compare empymod.readthedocs.io/en/v1.4.2 to empymod.readthedocs.io/en/v1.4.1. There is no docs-related change between the two versions, yet the citations are broken in v1.4.2 onwards.

It seems that this is related to a change in numpydoc from v0.6 to v0.7.0, see numpy/numpydoc#114 and numpy/numpydoc#136.

Wait for this issue to be resolved and verify that it fixes the problem with the empymod-docs.

For now, I set numpydoc==0.6.0 in requirements.txt.

[prisae]

OK, now also sphinx is fixed to sphinx==1.6.7, see readthedocs/readthedocs.org#4057. I guess these two things should be fixed together in once in the empymod-docs.

[prisae]

numpydoc==0.8.0 did not resolve the issue, see numpy/numpydoc#177.

[prisae]

Only using napoleon without numpydoc screws up some of the formatting. Re-opening.

[prisae]

Fixed with numpydoc v0.9.0.