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

Fix website rendering issues. #19

Open
brtnfld opened this issue Jan 15, 2025 · 8 comments
Open

Fix website rendering issues. #19

brtnfld opened this issue Jan 15, 2025 · 8 comments
Assignees

Comments

@brtnfld
Copy link
Member

brtnfld commented Jan 15, 2025

Something is weird in the contents list. For example, if I click on Grid Specification, it shows it in the main pane, but expands Auxiliary Data in the contents list. I don't see that behavior offline (but when I compile offline, I seem to be using a different theme. Are you seeing the same theme online and offline?).

The summaries also have excessive underlining. Is that intended?

@brtnfld
Copy link
Member Author

brtnfld commented Jan 15, 2025

I see the same theme off and online. It is much better rendered using the Firefox engine; it does not have the issue with Auxiliary data expansion. I don't see excessive underlining, but if there is no reason for the underlining, then it is not intended.

Would using a newer version of the theme help? At least for OpenSUSE, it uses v0.2; the latest release is v1.1.3.

@brtnfld
Copy link
Member Author

brtnfld commented Jan 15, 2025

At least for the pop-out issue:

executablebooks/sphinx-book-theme#865

@brtnfld
Copy link
Member Author

brtnfld commented Jan 15, 2025

If you scroll down, "Grid Specification" is only changed on the RHS panel once you get past the function list. I'm not sure why it is not resetting when you get to the "Grid Specification" header.

I tried with the lastest release of the theme and sphinx, same issue.

@smguzik
Copy link
Contributor

smguzik commented Jan 15, 2025

Maybe it is another issue with the theme. I must be using a much older version packaged with Debian. I like the formatting in the new version better, but everything is functional in the old one.

It's nice seeing the functions in the RHS panel, but if the contents depth is limited to 2, does the problem still exist? Shooting in the dark here.

@brtnfld
Copy link
Member Author

brtnfld commented Jan 16, 2025

It just does not like the bullet list. I've tried all the tricks I could think of and still nothing. I also tried it with the PyData Theme, which is based on the book theme and had the same issue.

I switched to a table format, which seems to work better.

@brtnfld
Copy link
Member Author

brtnfld commented Jan 16, 2025

Scratch that, with enough rows, it also has the same issue.

@brtnfld
Copy link
Member Author

brtnfld commented Jan 16, 2025

I think it is a nature of the theme, if you look at:

https://matplotlib.org/stable/api/matplotlib_configuration_api.html#default-values-and-styling

it has the same behavior.

@brtnfld
Copy link
Member Author

brtnfld commented Jan 17, 2025

I've asked the developers if this is expected behavior,

pydata/pydata-sphinx-theme#2096

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

3 participants