Readthedocs.org: move "RTD box" to left nav for non-default themes.

[cjw296]

Details

I was confused when I started using https://github.com/pradyunsg/furo as I couldn't see the version-picker-links-to-builds-etc box when using that theme, to the point where I put in a feature request: https://github.com/pradyunsg/furo/issues/25

As @pradyunsg pointed out, I see it on the right now, but that's not where I'd expect it to be, and for some themes it ends up looking pretty ugly:

https://pip.pypa.io/en/stable/

Expected Result

The box to be in the left nav, roughly where it would be for the default theme

Actual Result

It's over on the right, where I don't expect it, and where it looks ugly on themes which have a left nav, which I would hazard a guess to be all of them.

[humitos]

I'm not sure _where_ we are adding this, but I think this should be configurable.

[pradyunsg]

https://github.com/readthedocs/readthedocs.org/blob/a81d82ed736b611491050f39649bd668ef212c0f/readthedocs/core/static-src/core/js/doc-embed/footer.js#L79

The relevant point in code.

[pradyunsg]

FWIW, Furo now does place this correctly in the sidebar, although it needed reading of sponsorship.js here, and a bunch more investigation.

Here is how stuff looks with the development documentation for pip (big file, screenshot):

The tracking issue for the mismatched colors is https://github.com/readthedocs/ethical-ad-client/issues/37

[pradyunsg]

Oh, and here's what was the tracking issue for this on Furo's end: https://github.com/pradyunsg/furo/issues/23

[pradyunsg]

Oh, unless we're talking about the hover box thingie -- in which case, WHOOPS, coz I was talking about the ads. :)

[cjw296]

Yep, hover box thingy, which I think your screenshot still shows off on the right, whereas the RTD theme has it on the left, which I think it belongs...

[pradyunsg]

@cjw296 Ah, I assume you mean the sidebar.

That's non-trivial for the embedding JS here (which applies to all of ReadTheDocs) to implement while still respecting any designs that themes could have (eg: only right sidebars like Sphinx's own documentation). I expect Furo to get the relevant styling for RTD settled down at some point, but that's not today. :)