Updates for doc theme - Githubissues

Unidata / MetPy

MetPy is a collection of tools in Python for reading, visualizing and performing calculations with weather data.

https://unidata.github.io/MetPy/

BSD 3-Clause "New" or "Revised" License

1.26k stars 415 forks source link

Updates for doc theme #1764

Closed dopplershift closed 1 year ago

dopplershift commented 3 years ago

pydata-sphinx-theme released 0.5 with quite a few more configuration and customizable options. Some hightlights:

Color variables
Custom icons for links (rather than just github and twitter)--could add e.g. pypi
Edit this page options
Set pages to not have side bar
Navbar alignment
Header height

dopplershift commented 2 years ago

We can do this once the version chooser lands in a released version from upstream, at which point we'll be removing a bunch of our customization anyways.

dopplershift commented 2 years ago

At this time we should also update our Google Analytics setup since the current one will cease taking in data on 1 July 2023.

dopplershift commented 2 years ago

Might also consider looking at sphinx-design to handle our front page panels, since it's coming out the executable books project as well. We could avoid having to maintain HTML in index.rst.

mgrover1 commented 1 year ago

@dopplershift is this something you or Drew has taken a look at? If not - I am planning on overhauling Py-ARTs sphinx docs too and could try to draft something later this week.

dcamron commented 1 year ago

I should be pushing our fixes up for 1.5 this morning! 👍

mgrover1 commented 1 year ago

YAY! Very exciting!