Switch to the pydata sphinx theme

[mwcraig]

This theme was recently adopted by astropy and is pretty widely used by other large projects. Seemed better to switch pre-release rather than post-release.

Marking this as a draft for now because I need to copy over some CSS from astropy, I think...

Copied that over, still want to look at how they do the card setup here: astropy.rtfd.io

[mwcraig]

The test failure here is fixed in #258

[mwcraig]

Rebased to pull in #258.

I think further changes should wait until documentation is actually drafted. It looks like the pydata Sphinx theme has lots of customization options, for better or worse....

Best thing is that it has a dark mode 😀

[mwcraig]

To see a rendered version of the documentation click on the "Details" link for the ReadTheDocs check.

[JuanCab]

To see a rendered version of the documentation click on the "Details" link for the ReadTheDocs check.

Can you clarify what you mean here? I created a copy of the docs with tox but did you want me to check something else?

[JuanCab]

The only issue I see is when I brought up the HTML pages generated using tox -e build_docs, they had a dark background which made seeing the inheritance diagrams difficult. Might need some CSS tweaked.

[mwcraig]

Can you clarify what you mean here? I created a copy of the docs with tox but did you want me to check something else?

I meant this -- the documentation gets built on ReadTheDocs for every pull request 😀:

[mwcraig]

dark background which made seeing the inheritance diagrams difficult. Might need some CSS tweaked.

Looking into it...

[mwcraig]

I'm seeing legible inheritance diagrams on RTD, though they look different to me locally, investigating that...

[mwcraig]

No idea why the build looks the way it should on RTD but not locally 🤷‍♂️

[mwcraig]

I'm going to merge this so that I can do some documentation work today or tomorrow. Still not quite sure what is up with the inheritance diagrams locally, but since it works on RTD I figure that is good enough.