Both inline plots and plots from script files work.
Some things to keep in mind:
- for including scripts from docstrings, use prefix "../plots/",
for including scripts in a rst file, use "plots/".
This is due to the docs being generated from the source/api folder.
- inline plots are not (yet) aware of variables being defined earlier
in the Examples section.
- we now use the numpydoc sphinx extensions, the original MPL ones can not
be used because they have no support for the make file and conf.py not
being in the same folder.
There is one minor thing that does not work yet. The source code link for
plots does not work because for some reason the script files are not
copied to the build dir.