search

N8-CIR-Bede / documentation

Documentation for the N8CIR Bede Tier 2 HPC faciltiy
https://bede-documentation.readthedocs.io/en/latest/
7 stars 11 forks source link

Theme: Improve formatting of long page names in the sidebar #77

Closed ptheywood closed 2 years ago

ptheywood commented 2 years ago

The sidebar includes links to the previous and next page at the bottom.

As each of these links only has 50% of the sidebar width available, the cotent often wraps poorly, and many page names are compacted.

Adjusting the theme to improve this may be worthwile.

image

For larger window widths, there is a lot of unused whitespace that could be used to allow wider content, and a wider sidebar.

At narrower widths (but above the mobile/tablet breakpoint) there is ~ 100px of unused whitespace on the left which could be used.

The font size may also need adjusting based on screen resolution or other CSS changes.

ptheywood commented 2 years ago

In my WIP branch on #67 I've had to change the sidebar behaviour in general to provide a global toc rather than a local toc for it to be useful (otherwise it would be empty on most pages).

I'd previously adjusted the CSS for the relations.html sidebar components, but with the width of the sidebar used by the sphinx bootstrap theme it did not render well for anything other than short names. With the change to a globaltoc sidebar, I've removed the relationship links to resolve this. I'll close this one #67 is merged (if it still contains this proposed change)