A clean book theme for scientific explanations and documentation with Sphinx
Project description
sphinx-book-theme
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 5 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
Built Distribution
File details
Details for the file sphinx_book_theme-1.1.3.tar.gz
.
File metadata
- Download URL: sphinx_book_theme-1.1.3.tar.gz
- Upload date:
- Size: 434.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1f25483b1846cb3d353a6bc61b3b45b031f4acf845665d7da90e01ae0aef5b4d |
|
MD5 | 8b5ea55eed06201896c9dd716c07a0d6 |
|
BLAKE2b-256 | 896961dfa3b3851610b5f45960737bd99f8c5b2d70ba73f9ac84a527e0c564ae |
Provenance
File details
Details for the file sphinx_book_theme-1.1.3-py3-none-any.whl
.
File metadata
- Download URL: sphinx_book_theme-1.1.3-py3-none-any.whl
- Upload date:
- Size: 430.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a554a9a7ac3881979a87a2b10f633aa2a5706e72218a10f71be38b3c9e831ae9 |
|
MD5 | 16cd918af0dddb10a31ba4e48aef66d1 |
|
BLAKE2b-256 | 2b8090574e2e82c955b9c6f6b77f7badb2cf2ef4ef77599e4343cced2d098681 |