A clean book theme for scientific explanations and documentation with Sphinx
Project description
quantecon-book-theme
A Jupyter Book Theme for QuantEcon Book Style Projects
Usage
To use this theme in Jupyter Book:
- Install the theme
pip install git+https://github.com/QuantEcon/quantecon-book-theme.git
- Add the theme to your
_config.yml
file:
sphinx:
config:
html_theme: quantecon_book_theme
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
pytest
in 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
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 quantecon_book_theme-0.7.5.tar.gz
.
File metadata
- Download URL: quantecon_book_theme-0.7.5.tar.gz
- Upload date:
- Size: 2.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 96421d8d2ba64d73258784011cbb615f2df927a960cb4cbf25f7a149b6e60911 |
|
MD5 | 744c12d537c9b7ec6214a14f1b8e3c91 |
|
BLAKE2b-256 | 5d43e8d565036f969dacf4a216397795be72778e80a308119ebe83eb04811373 |
File details
Details for the file quantecon_book_theme-0.7.5-py3-none-any.whl
.
File metadata
- Download URL: quantecon_book_theme-0.7.5-py3-none-any.whl
- Upload date:
- Size: 282.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2fd4f9e3a5ed276d866dc3af8d7f4324b8e4a6f5c3c01aba4b0006bc74327b7a |
|
MD5 | 811543bdc250427c22aa7f466f988a14 |
|
BLAKE2b-256 | d27b011fbd173545a2c797a2ad7d2a0d9ba0a6710d783a46a9464efea3a9024d |