A Sphinx theme designed for QTextBrowser
pip install quark-sphinx-theme==0.6.0
Quark is a Sphinx theme specifically designed to look and work well within the limitations of the Qt toolkit's QTextBrowser.
This theme was originally designed for the bundled manual of SpeedCrunch.
$ pip install quark-sphinx-theme
conf.py
html_theme = 'quark'
# generate QTextBrowser-compatible HTML4 instead of something newer
html4_writer = True
# To enable more QTextBrowser-compatible HTML generation:
extensions = ['quark_sphinx_theme.ext.html_rewrite']
quark_sphinx_theme/__init__.py
v<version>
, e.g. v0.6.0
html_rewrite
extension to properly load on other HTML-based
builders (e.g. the qthelp
builder).html_rewrite
extension modifies the HTML builder to
be less invasive.sphinx.html_themes
entry point to allow loading the theme
automatically, without setting html_theme_path
.css_files
variable in the basic theme's template broke
the extra_css_files
theme setting.python_requires
in setup.py.quark_html_rewrite_features
to quark_html_features
.quark_html_disabled_features
to explicitly turn off certain rewrite
features.::hlist
directive.hide_sidebar_in_index
option.quark_sphinx_theme.ext.html_compat
extension has been renamed to
quark_sphinx_theme.ext.html_rewrite
. The old name remains supported for
backwards compatibility.html_rewrite
extension now supports wrapping admonitions in tables,
allowing for more styling options. The theme has been updated to take
advantage of this. Admonitions, topics, and sidebars look very different and
much better. If html_rewrite
is not enabled, a fallback style will be
used for these.html_rewrite
supports wrapping literal blocks in tables. If enabled,
this provides better styling for Pygments styles with non-white backgrounds.quark_sphinx_theme.ext.html_compat
extension.rubric
directives.