You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
There are at least a dozen packages that use various themes for publishing their documentation. Plone 6 Documentation uses a lightly customized theme of Sphinx Book Theme, which in turn is based on PyData Sphinx Theme, and sharing these modifications across all packages is not maintainable.
To remedy this situation, we should create a new theme named plone-sphinx-theme. It would have tests that check functionality, display, and layout, using the similar test suites from the parent themes.
There exists a Sphinx theme repository in the Plone organization already, but it might not be the best fit going forward.
stevepiercy
changed the title
Create a Plone Documentation Sphinx theme package
Create or reuse a Sphinx theme package for Plone 6 Documentation?
Apr 20, 2023
Create a new one. Sphinxtheme.plone has the ones for the 5, 4 and 3 versions of the docs, and is on palliative care by me to keep it running and cludgel in things like version drop-downs to the current version. Having a completely different theme in there in a branch is just a recipe for brain melt
Plone Documentation versions affected
Description
There are at least a dozen packages that use various themes for publishing their documentation. Plone 6 Documentation uses a lightly customized theme of Sphinx Book Theme, which in turn is based on PyData Sphinx Theme, and sharing these modifications across all packages is not maintainable.
To remedy this situation, we should create a new theme named
plone-sphinx-theme
. It would have tests that check functionality, display, and layout, using the similar test suites from the parent themes.There exists a Sphinx theme repository in the Plone organization already, but it might not be the best fit going forward.
Refs:
The text was updated successfully, but these errors were encountered: