Why are we using the ugliest possible sphinx theme for the docs again?

[ghost]

@wesm, any objection to changing over to "nature"?

[wesm]

None here.

[ghost]

done. fbc7109

[wesm]

Have you looked at the new docs theme to assess it's usability? There's no navigation sidebar which was the whole point of the other theme. Ideas?

[ghost]

I compiled the docs and opened them in a browser, I got a sidebar on the left with the topic TOC
instead of the older "chapters". you consider that a bad bargain?

[ghost]

Modified the Sphinx theme to use the toc tree. pushed. also removed the OLS docs matching the code removed
earlier.

Can close?.

[ghost]

Also, switched to using the bundled mpl style, and made plot image size consistent
everywhere.

Huge improvement on both fronts IMO.

[jreback]

+1 on new layout and graphs

[changhiskhan]

This is sweet. +1e6 for sane matplotlib defaults. I assume the new TOC layout navigates the same as before (except that it's on the left instead of the right)? I'm getting greedy but does the TOC scroll separately? Would be nice to have the TOC handy no matter where you are on the page.

[ghost]

it's a a canned template macro provided by sphinx, I just mashed up
agogo (the prev theme) with the new one and went through the
"pixel alignment boogie" for an hour.

Pretty easy to make the TOC div position:fixed, but maybe better to have it fold away and back,
freeing up screen real-estate.
as you know the previous template (customized?) had a tendency for the TOC to occlude the content,
putting the TOC on the left does a better job I think.

[jreback]

I think maybe the menu should move as well....can you post what I would need to change to try it?

[ghost]

+1 *2 is good enough for me. I'll take care of it.

[ghost]

Done. with a little flare for good measure. a625fbd

[hayd]

This is great!

[ghost]

But it breaks (UX wise) when the bottom TOC entries are off the viewport.
Don't think we can keep this.

Thanks @hayd.

[hayd]

@y-p off the viewport?

[ghost]

The visible portion of the document.

pushed a fix, sticky everywhere except the API page.

[ghost]

I reverted back to the regular "TOC scrolls off the screen" behaviour, there are several
items which don't fit on the screen and it's not worth the hassle to handle that properly.
So I'm settling for the old theme's behvaior, only looking much better.

If anyone wants to take a trip down javascript lane, be my guest.

[wesm]

Thanks @y-p