Skip to content

Docs: Replace sphinx-tabs with sphinx-design #9856

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

Closed
4 tasks
benjaoming opened this issue Jan 3, 2023 · 2 comments
Closed
4 tasks

Docs: Replace sphinx-tabs with sphinx-design #9856

benjaoming opened this issue Jan 3, 2023 · 2 comments

Comments

@benjaoming
Copy link
Contributor

benjaoming commented Jan 3, 2023

We already have sphinx-design in use and it provides a tab widget that can replace sphinx-tabs.

This includes:

#9855 deals with a set of warnings possibly caused by sphinx-tabs and potentially solved by using sphinx-design instead, but we haven't investigated that.

@benjaoming
Copy link
Contributor Author

I was chatting with Executable Book people and as I understand it, sphinx-tabs is well-maintained and will likely continue to exist.

It's a bit like Unix philosophy for Sphinx extensions... "do one thing and do it well"

I actually prefer the look&feel of sphinx-tabs, and since we already have a bit of custom JS logic to auto-open tabs, I think we should actually keep sphinx-tabs around and expect it to be there for the longer run :)

@benjaoming
Copy link
Contributor Author

Btw... sphinx-tabs supports Sphinx 6 already... and sphinx-design doesn't yet.

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

1 participant