Skip to content

Latest commit

 

History

History
64 lines (41 loc) · 6.74 KB

README.md

File metadata and controls

64 lines (41 loc) · 6.74 KB

Brightway Interactive Learning (based on Jupyter Book)

Brightway License contributions welcome
Maintainance Team: @michaelweinold

The interactive learning and teaching documentation for the Brightway life-cycle assessment software package. Readthedocs.org with the Jupyter Book Theme and the Thebe tool are used to build/host the interactive documentation.

static documentation interactive documentation development playground
docs.brightway.dev learn.brightway.dev live.brightway.dev

Quickstart

Setup Repository

  1. Clone this repository:
git clone https://github.com/brightway-lca/brightway-book.git

Setup Python Environment

Set up a Python virtual environment that includes all packages required to build the documentation. A Conda environment file is provided for convenient setup. The file is located at ./environment.yml. Install the environment jbook by running from the repository root directory:

conda env create -f environment.yml

and activate the environment:

conda activate jbook

Building the Documentation

Tip

You can check the Jupyter Book documentation for further information on how to structure your content.

  1. You can build the documentation by running the build command:
jupyter-book build ./
  1. Preview the built documentation by opening the generated html file:
_build/html/index.html

Publishing the Documentation

  1. Create a pull request to have a maintainer merge your changes into the main branch. As soon aschanges have been merged, Readthedocs.org will build the documentation and deploy it.

📚 References

Compare the jupyter-book:

  1. documentation
  2. feature requests queue
  3. discussions on GitHub