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

Update versions of Sphinx and its plugins #472

Merged
merged 7 commits into from
Mar 27, 2024
Merged

Update versions of Sphinx and its plugins #472

merged 7 commits into from
Mar 27, 2024

Conversation

santisoler
Copy link
Member

Bump versions of Sphinx and its plugins in environment.yml and in requirements-docs.txt. Add CSS dark-light class to Harmonica logo in the index.rst to make its background transparent even in dark mode. Remove Harmonica logo in the left panel.

Relevant issues/PRs:

Similar changes to the ones applied in fatiando/choclo#64

@santisoler
Copy link
Member Author

With this version of Sphinx and the Book theme, we have dark theme in Harmonica docs. This introduced some issues regarding the rendering of output cells. The ones that show Pandas outputs are working after applying some CSS rules. But for xarray outputs things are harder.

Here are screen captures of light vs dark mode with xarray outputs:

Screenshot from 2024-03-12 15-09-10
Screenshot from 2024-03-12 15-09-20

@santisoler santisoler marked this pull request as ready for review March 12, 2024 22:27
@leouieda
Copy link
Member

Yeah I noticed that. I think it'll just be a matter of time before xarray makes a fix to their CSS.

@santisoler
Copy link
Member Author

Just saw that Xarray's docs make use of Jupyter Books to build them and their HTML outputs look nice on dark theme: https://tutorial.xarray.dev/intermediate/xarray_ecosystem.html

@santisoler santisoler added this to the v0.7.0 milestone Mar 25, 2024
@santisoler
Copy link
Member Author

I'm merging this. We can take care of the Xarray inconsistency in another PR.

@santisoler santisoler merged commit 2d39034 into main Mar 27, 2024
18 checks passed
@santisoler santisoler deleted the update-sphinx branch March 27, 2024 19:17
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

Successfully merging this pull request may close these issues.

2 participants