python / python-docs-theme

Sphinx theme for Python documentation
Other
74 stars 58 forks source link

Missing links on doc pages: modules and index #155

Open mark-summerfield opened 11 months ago

mark-summerfield commented 11 months ago

I use large fonts so even on a big screen when I view the Python docs the links at the top that end with "previous | next | modules | index" disappears.

This wouldn't be a problem since a menu button appears instead of that line.

However, the menu that drops down does not have the modules or index links.

I've bookmarked the modules page but even so it is poor that it isn't available any other way.

hugovk commented 11 months ago

Here's some screenshots to illustrate.

With Chrome (116 on macOS Ventura 13.5) this is https://docs.python.org/3/library/string.html in "normal" view, we can see the "previous | next | modules | index" links at the top:

"Normal" view ![image](https://github.com/python/cpython/assets/1324225/7c8eddd3-109d-4c8d-9330-d9b2e0becd3f)

If we zoom in (command + +) three times to 150%, we get a "mobile" layout, and the left and top menus are gone:

"Mobile" view ![image](https://github.com/python/cpython/assets/1324225/4b4868a5-3289-4fea-bc62-0d597c1fad6c)

We can view the left menu but not the top one:

"Mobile view" with menu ![image](https://github.com/python/cpython/assets/1324225/3df2f32f-81fc-40c5-83f8-2fae00fdbc77)

However, there's an alternative. Instead of zooming in (command + 0 resets to 100%), the browser has font size settings: chrome://settings/?search=font+size > "Font size", which can be changed from, for example, "Medium (Recommended)" to "Large" or "Very large":

Font settings ![image](https://github.com/python/cpython/assets/1324225/90b17416-a823-4ee2-ad54-83a9b753e4dd)

Here's large:

Large font ![image](https://github.com/python/cpython/assets/1324225/39fb7375-d041-4fd3-ba90-f562eac36f06)

And very large:

Very large ![image](https://github.com/python/cpython/assets/1324225/26a20303-7822-41c2-bda8-4ef50ab812df)

Both of which keep the original "desktop" layouts. Do either of those help?

mark-summerfield commented 11 months ago

I'm using Firefox on Linux Screenshot 1 shows the modules & index links but at a zoom level that is far too small for me to use. Screenshot 2 shows the same page at the zoom level I need. Screenshot 3 shows another page at the zoom level I need and with the popup menu shown As you can see for Screenshots 2 and 3 there are no modules or index links.

Screenshot 1 ![Screenshot1](https://github.com/python/cpython/assets/1773348/cff3b1e0-58ac-4c11-99ee-4667de23a3ba)
Screenshot 2 ![Screenshot2](https://github.com/python/cpython/assets/1773348/ccd36b60-ab25-4963-87fa-5acfda9c4557)
Screenshot 3 ![Screenshot3](https://github.com/python/cpython/assets/1773348/0bf95886-1a65-47a1-a050-194849a858d7)
hugovk commented 11 months ago

Hmm, I also see Firefox has different way of handling changing the font size.

I'll transfer this issue from https://github.com/python/cpython to https://github.com/python/python-docs-theme that handles this code, to see what others think.

mark-summerfield commented 11 months ago

Thank you. Although using a bookmark to modules works it means 2 clicks every time (Bookmarks menu, then modules bookmark) rather than 1 which is irritating!