sampledoc

sampledoc copied to clipboard

There are important differences between sphinxdoc.css and basic.css from sphinx installation directory and https://matplotlib.org/sampledoc/ With the css from the installation directory the hrefs in the sitebar are not working. So...

bertarends

Where is the sphinxext dir?

6

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

twiecki

Customization steps fail on windows

3

Hi, I am having trouble with the "customizing the look and feel" step Issue is documented on stackoverflow here http://stackoverflow.com/questions/34856081/sphinx-tutorial-problems

fiftysevendegreesofrad

use the numpydoc package instead of bundling a numpydoc.py file

3

[numpydoc](https://github.com/numpy/numpydoc) is now its own project which can be installed with pip or other OS/distribution package managers. Would make sense to remove sphinxext/numpydoc.py from sampledoc?

argriffing

An .rst reference seems to be broken in extensions.rst. I'm not sure what is the intended behavior. ``` :ref:`extensions-literal` ```

argriffing

a matplotlib sphinx extension has moved into ipython

1

This causes a warning when I build sampledoc. ``` MatplotlibDeprecationWarning: The Sphinx extension ipython_console_highlighting has moved from matplotlib to IPython, and its use in matplotlib is deprecated. Change your import...

argriffing

I get to the repo to learn how to use Sphinx, but I find it really not that easy for Windows users. 1st, I shall look for the Sphinx scripts...

hisen630

First of all: thanks for making this great tutorial! It doesn't work with matplotlib HEAD though, because `matplotlib/sphinxext/ipython_directive.py` no longer exists. This worked for me: `cp ipython/docs/sphinxext/ipython_directive.py sampledoc/sphinxext` After that...

cdeil