ReadTheDocs version selector always on top for mobile displays

[chrisjsewell]

When hosted on ReadTheDocs, the dropdown menu that they inject is permanently on display, which is IMO not ideal.
By contrast, with the RTD theme, it is hidden in the menu bar.

Resources

Here are pointers to how the RTD theme does this:

• Here's the layout.html template for this
• Here's another HTML template

[chrisjsewell]

Whilst I'm being nit-picky, the drop-down menu could also be formatted a bit nicer: some better line spacing, and maybe a different background color, for example like the VS Code theme:

[choldgraf]

Yeah, I'm pretty sure there's a specific HTML metadata you can add to a theme that will cause RTD to put ads there instead of in the overlay. Can't remember what it is though

(would be helpful if you opened separate issues for different comments/requests - e.g., to discuss spacing in the drop-down)

[jorisvandenbossche]

specific HTML metadata you can add to a theme that will cause RTD to put ads there instead of in the overlay

I seem to also remember that this was possible for adds (but also don't directly find it ..). But what @chrisjsewell was mentioning is the "version widget". And for that I am not aware of ways to better integrate that in your custom theme.

[choldgraf]

ah - good call, I missed that. I assume the widget should behave the same way? But maybe not. And if not, we should mention to RTD that the widget isn't very mobile-friendly. Maybe they'd allow a single-icon version for narrow screens?

[choldgraf]

I looked into the RTD version widget customization, and it seems like the way that they do it is to define a custom template.

• Here's the layout.html template for this
• Here's another HTML template

It's a bit unclear to me how these two work, maybe @ericholscher could point to an explainer? I think we want to implement something like this so that we can put the RTD selector in the sidebar instead of floating in the bottom right.