Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing links on doc pages: modules and index #155

Open
mark-summerfield opened this issue Aug 31, 2023 · 4 comments
Open

Missing links on doc pages: modules and index #155

mark-summerfield opened this issue Aug 31, 2023 · 4 comments

Comments

@mark-summerfield
Copy link

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
Copy link
Member

hugovk commented Aug 31, 2023

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

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

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

"Mobile view" with menu

image

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

Here's large:

Large font

image

And very large:

Very large

image

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

@mark-summerfield
Copy link
Author

mark-summerfield commented Aug 31, 2023

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

Screenshot 2

Screenshot2

Screenshot 3

Screenshot3

@hugovk
Copy link
Member

hugovk commented Sep 1, 2023

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.

@hugovk hugovk transferred this issue from python/cpython Sep 1, 2023
@mark-summerfield
Copy link
Author

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!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants