I've released version 0.1.1 of the Sizzle theme on PyPI. To use it, simply do
pip install sphinx_sizzle_theme
and then specify 'sizzle' as your Sphinx theme.
This release introduces some new features. Changes:
* Meta tags added to layout, so that the meta directive can be used.
* The size constraint was changed on header elements, for an improved display.
* Empty field bodies are now handled correctly.
* The TOC input box now sticks to near the top of the browser window.
* Support for Iconify icons (over 100,000 icons) was added.
* Updated client-side libraries.
Theme highlights:
* Layout uses a small header with search box, prev/next links and index link
* Sidebar is hideable and showable with keyboard or mouse
* Entries in the TOC can be filtered by typing in what you want to match on -
handy for long TOCs / larger projects
* Sidebar and content area can scroll independently (useful for larger projects)
* Typography changes - Font Awesome is integrated, slightly more condensed fonts
than are used in Guzzle (e.g. Roboto rather than Open Sans), Iconify icons supported
* Support for additional Google Fonts
* Styled lists using Font Awesome icons
* Summary/detail functionality using styled lists
* Some custom roles, including one for Font Awesome icons and one for Iconify icons
* Tooltips in your documentation that you can customize
* Improved hooks for your custom JavaScript to be called on document load, etc.
You can see an example of the theme using its own documentation:
https://docs.red-dove.com/sphinx_sizzle_theme/and for a larger project:
https://docs.red-dove.com/distlib/I'd be grateful for any feedback about the theme and/or its documentation.
The development repository is currently at
https://bitbucket.org/vinay.sajip/sphinx_sizzle_theme/and issues can also be raised there.
Regards,
Vinay Sajip