mirror of
https://github.com/Kladdy/sphinx-book-theme
synced 2026-05-21 08:48:06 +02:00
No description
- Jupyter Notebook 59.7%
- Python 18.4%
- HTML 11.3%
- SCSS 7.8%
- JavaScript 2.4%
- Other 0.4%
| .github | ||
| docs | ||
| src/sphinx_book_theme | ||
| tests | ||
| .flake8 | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .readthedocs.yml | ||
| ARCHITECTURE.md | ||
| CHANGELOG.md | ||
| codecov.yml | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| package.json | ||
| pyproject.toml | ||
| README.md | ||
| tox.ini | ||
| webpack.config.js | ||
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.