Skip to main content

A clean book theme for scientific explanations and documentation with Sphinx

Project description

sphinx-book-theme

codecov Documentation Status PyPI

An interactive book theme for Sphinx.

This is a lightweight Sphinx theme designed to mimic the look-and-feel of an interactive book. It has the following primary features:

  • Bootstrap 4 for visual elements and functionality.
  • Flexible content layout that is inspired by beautiful online books, such as the Edward Tufte CSS guide
  • Visual classes designed for Jupyter Notebooks. Cell inputs, outputs, and interactive functionality are all supported.
  • Launch buttons for online interactivity. For pages that are built with computational material, connect your site to an online BinderHub for interactive content.

Get started

To get started with sphinx-book-theme, first install it with pip:

pip install sphinx-book-theme

then, activate the theme in your Sphinx configuration (conf.py):

...
html_theme = "sphinx_book_theme"
...

This will activate the Sphinx Book Theme for your documentation. Note that you may need to change your html_theme_options configuration depending on your previous theme. See the pages to the left for information about what you can configure with sphinx-book-theme.

Documentation

See the Sphinx Book Theme documentation for more information.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx_book_theme-0.3.0rc1.tar.gz (266.3 kB view details)

Uploaded Source

Built Distribution

sphinx_book_theme-0.3.0rc1-py3-none-any.whl (326.3 kB view details)

Uploaded Python 3

File details

Details for the file sphinx_book_theme-0.3.0rc1.tar.gz.

File metadata

  • Download URL: sphinx_book_theme-0.3.0rc1.tar.gz
  • Upload date:
  • Size: 266.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for sphinx_book_theme-0.3.0rc1.tar.gz
Algorithm Hash digest
SHA256 0e9259bd67e439b295a4ffaf6f59d0132c8172a3cbbba7451cdb6c244f7de0a2
MD5 26c1f0e8e577c2b64ddda609464abfe5
BLAKE2b-256 150279c52fcff69d9b9ce30d28a898e1b99440082dfdb50120e36178dc5c6c66

See more details on using hashes here.

File details

Details for the file sphinx_book_theme-0.3.0rc1-py3-none-any.whl.

File metadata

  • Download URL: sphinx_book_theme-0.3.0rc1-py3-none-any.whl
  • Upload date:
  • Size: 326.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for sphinx_book_theme-0.3.0rc1-py3-none-any.whl
Algorithm Hash digest
SHA256 71fa6e8c4f65601621dc3ebbc7f77ab927cb091e2ddce10254ec3aaadb6b2f91
MD5 a098ad3c27693ffce542f861889c3da5
BLAKE2b-256 4e5d5ea984eec2c6fd7fad82a587d1e07675122f83f4ce6b116f37ca8fa4f258

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page