A clean and modern Sphinx theme.
Allow parallel builds.
Thanks to @explode for reporting this issue.
Added additional ordered list styles - thanks to @fizbin for reporting this.
Fixed span tags (thanks to @jvcarli for this).
Added support for Python 3.12.
Added z-index
for the left sidebar on mobile.
Fixes to support Sphinx 7.2. Thanks to @alexlancaster for reporting this.
Bundling the Roboto Mono bold-italic font with the theme, as it's used in some code blocks. Thanks to @noxpardalis for adding this.
The custom fonts are now bundled with the theme. Thanks to @noxpardalis for this.
Full Changelog: https://github.com/piccolo-orm/piccolo_theme/compare/0.14.0...0.15.0
When switching to dark mode, we automatically apply our own custom dark mode styles to code blocks.
This gives a great experience out of the box. However, if someone uses their own Pygments theme, they might want to use that theme in both light mode, and dark mode. They can now do so, using the dark_mode_code_blocks
option.
# conf.py
html_theme_options = {
"dark_mode_code_blocks": False
}
A logo can now be used in the nav bar, instead of text.
# conf.py
# Relative to conf.py:
html_logo = './path/to/logo.png'
# Or an absolute URL:
html_logo = 'https://awesome.com/static/logo.png'
Thanks to @are-scenic for adding this.