sphinx-multiversion to replace sphinxcontrib-versioning?

[rjleveque]

We've been using sphinxcontrib-versioning to make doc pages with links to other versions, but I can't get this to work any more after updating various other Python packages. I ran into various issues, only some of which I could fix based on
sphinx-contrib/sphinxcontrib-versioning#70
and that issue makes me think this package may not be well supported going forward.

So I've tried switching to this new package:
https://holzhaus.github.io/sphinx-multiversion/master/index.html
which seems to work well and has some other advantages over the old way, I think. In particular:

• It's easy to specify which branches/tags should be included in the versions listed and to customize the sidebar,
• You can build all the versions within your local repo with what's in your branches, rather than having to push everything to GitHub in order for it to be included in the docs.

I posted a new version of the docs at
http://depts.washington.edu/clawpack/sampledocs/sphinx-multiversion/contents.html

Feedback welcome!

[mandli]

There are some links that are broken and I am wondering if this is a relative path problem? For example the page for geoclaw has some warnings (as does other pages).

[mandli]

Looks great otherwise!

[rjleveque]

Yes, I forgot to mention that nbsphinx is also not working for me now, so pages generated automatically from notebooks are failing. Still working on that...

[rjleveque]

I will go ahead with this unless there are any objections.

I'd also like to make some other changes, listed in #210.