matplotlib/sampledoc

Where is the sphinxext dir?

twiecki opened this issue · 6 comments

twiecki commented

https://matplotlib.org/sampledoc/extensions.html tries to copy the files from a sphinxext dir in this repo which doesn't seem to exist.

mattagape commented

Yes, but according to the tutorial, sphinxext/ should contain the following files:
apigen.py docscrape.py docscrape_sphinx.py numpydoc.py
And the link provided by @timhoffm doesn't have those.

kiteloopdesign commented

Same issue here. What a pity that the main example for sphinx is not working. Thanks anyway

JenningsAutomation commented

same issue as above. I guess nobody's watching this repository. Same issue for 3 years. No sphinxext dir

home:~/tmp/sampledoc> mkdir sphinxext
home:~/tmp/sampledoc> cp ../sampledoc_tut/sphinxext/*.py sphinxext/
home:~/tmp/sampledoc> ls sphinxext/
apigen.py  docscrape.py  docscrape_sphinx.py  numpydoc.py
jklymak commented

I agree this is largely unmaintained and is here for historical purposes. OTOH if someone wanted to modernize it, I'm sure volunteers would be welcome.

xiaoouwang commented

For all those stuck with this problem see here https://github.com/numpy/numpydoc/tree/main/numpydoc
Based on my test the apigen.py is not necessary.