quantecon-book-theme
A Jupyter Book Theme for QuantEcon Book Style Projects
Features
- Clean, professional design optimized for technical and academic documentation
- Git-based metadata - Automatic display of last modified dates and interactive changelog with commit history
- Collapsible stderr warnings - Automatically wraps verbose warnings in notebook cells with an expandable interface
- Jupyter Notebook support with visual classes for cell inputs, outputs, and interactive functionality
- Configurable code syntax highlighting - Choose between custom QuantEcon styles or Pygments built-in themes
- Launch buttons for online interactivity via BinderHub
- Flexible content layout inspired by beautiful online books
- Bootstrap 4 for visual elements and functionality
- Built on PyData Sphinx Theme inheriting robust features and design patterns
Usage
To use this theme in Jupyter Book:
- Install the theme
pip install quantecon-book-theme
- Add the theme to your
_config.ymlfile:
sphinx:
config:
html_theme: quantecon_book_theme
Configuration Options
The theme supports various configuration options in your conf.py or _config.yml:
html_theme_options = {
"repository_url": "https://github.com/{your-org}/{your-repo}",
"use_repository_button": True,
"use_issues_button": True,
"use_edit_page_button": True,
# Git metadata (new in v0.12.0)
"last_modified_date_format": "%b %d, %Y", # Date format for last modified
"changelog_max_entries": 10, # Number of commits to show in changelog
# Code highlighting (new in v0.10.0)
"qetheme_code_style": True, # False to use Pygments built-in styles
}
# When using Pygments styles
pygments_style = 'friendly' # or 'monokai', 'github-dark', etc.
See the full documentation for all configuration options.
Development
Testing
This project uses tox for running tests across multiple Python versions:
# Run full test suite
tox
# Run pre-commit checks
pre-commit run --all-files
Important: Always use tox instead of running pytest directly to ensure proper environment isolation and multi-version testing.
Updating Fixtures for Tests
Updating test regression files on layout changes
It is advisable to update the test files for file regression checks when releavant layout files change.
For example, at present we have a sidebar file-regression check to validate html across tests.
The file which it compares against is tests/test_build/test_build_book.html.
If updating the sidebar html, then one of the easier steps to update this test file is:
- Delete the file
tests/test_build/test_build_book.html. - Run
pytestin your command line, which will then generate a new file. Check if the file is at par with your expectations, contains elements which you added/modified.
Now future pytests will test against this file, and the subsequent tests should pass.
Contributing Guide
The docs for the contributing guide of this repository: https://github.com/QuantEcon/quantecon-book-theme/blob/master/docs/contributing/index.md
Release files for quantecon-book-theme 0.22.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| quantecon_book_theme-0.22.1.tar.gz | 8.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| quantecon_book_theme-0.22.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.2 MB
Release files / quantecon_book_theme-0.22.1.tar.gz
| Download URL | quantecon_book_theme-0.22.1.tar.gz |
|---|---|
| Size | 8.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
511313985d05554feff4a6379a07c10aa0a9443096880dfff089476b1ad7b7d7
|
|
BLAKE2b-256 checksum How to use checksums |
4da6fcb1e8eec0224f33826ef05e45230277ab6818afecb3828c6371f3710d81
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / quantecon_book_theme-0.22.1-py3-none-any.whl
| Download URL | quantecon_book_theme-0.22.1-py3-none-any.whl |
|---|---|
| Size | 616.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6ef4394fd5611549bf3878a5123e0f03abb7a85d246cc171981a86ad06d2abae
|
|
BLAKE2b-256 checksum How to use checksums |
e5481c14cb22278a90df0c8f4f8eb6c706165a0a4fab730c4c91aa523c4c353c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
