Skip to main content

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:

  1. Install the theme

pip install git+https://github.com/QuantEcon/quantecon-book-theme.git

  1. 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:

  1. Delete the file tests/test_build/test_build_book.html.
  2. 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


Download files

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

Source Distribution

quantecon_book_theme-0.7.5.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

quantecon_book_theme-0.7.5-py3-none-any.whl (282.8 kB view details)

Uploaded Python 3

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

Hashes for quantecon_book_theme-0.7.5.tar.gz
Algorithm Hash digest
SHA256 96421d8d2ba64d73258784011cbb615f2df927a960cb4cbf25f7a149b6e60911
MD5 744c12d537c9b7ec6214a14f1b8e3c91
BLAKE2b-256 5d43e8d565036f969dacf4a216397795be72778e80a308119ebe83eb04811373

See more details on using hashes here.

File details

Details for the file quantecon_book_theme-0.7.5-py3-none-any.whl.

File metadata

File hashes

Hashes for quantecon_book_theme-0.7.5-py3-none-any.whl
Algorithm Hash digest
SHA256 2fd4f9e3a5ed276d866dc3af8d7f4324b8e4a6f5c3c01aba4b0006bc74327b7a
MD5 811543bdc250427c22aa7f466f988a14
BLAKE2b-256 d27b011fbd173545a2c797a2ad7d2a0d9ba0a6710d783a46a9464efea3a9024d

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