josh-fell commented on issue #29267: URL: https://github.com/apache/airflow/issues/29267#issuecomment-1837734706
I was hoping for exactly this functionality when writing docs for something else, but alas. Thanks for logging this @BasPH! After digging into this, `sphinx-tabs` unfortunately has a few issues. This extension is installable, but when running `build-docs` it seems as though `pip` resolves this extension to such an old version (1.3.3) that [deprecated `Sphinx` code is used](https://github.com/sphinx-doc/sphinx/issues/9975) and the build fails. Ultimately, more recent versions conflict with both our `docutils` (Airflow required <0.17.0; `sphinx-tabs` needs ~=0.18.0) and `Sphinx` constraints (Airflow requires >=5.2.0; `sphinx-tabs` has a <5 constraint until the most recent version). Luckily there is another extension which I plan on using: [`sphinx_design`](https://sphinx-design.readthedocs.io/en/alabaster-theme/index.html). Not only does this extension support tabs, but Grids, Cards, Dropdowns, and other components come out of the box. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
