ucsb-ds-capstone-2022.github.io's Introduction

UCSB Data Science Capstone Projects 2022

This Jupyter book contains work from UCSB's Data Science Capstone Project Class sequence: https://ucsb-ds-capstone-2022.github.io/

Jupyter Book with Github Pages

https://jupyterbook.org/publish/gh-pages.html

Building locally for development

If you'd like to develop on and build the UCSB Data Science Capstone Projects 2022 book, you need to setup your environment:

Install Anaconda

Create a virtual environment. Let's call it jb:

conda create -n jb python=3.8
conda activate jb

Clone and build Capstone 2022 Jupyter book repository:

git clone https://github.com/ucsb-ds-capstone-2022/ucsb-ds-capstone-2022.github.io.git
pip install -r ucsb-ds-capstone-2022.github.io/requirements.txt	## install python dependencies
conda activate jb                   				## makes newly installed packages available
cd ucsb-ds-capstone-2022.github.io/ucsb_ds_capstone_projects_2022
jupyter-book build .

Rendered HTML version of the book will be in ./ucsb_ds_capstone_projects_2022/_build/html/.
Start local webserver using Python:
```
cd _build/html
python -m http.server
```

(Optional) Issuing build command and reloading browser can be automated. Using live.js and some command line codes below can improve your experience.

# cd ucsb-ds-capstone-2022.github.io/ucsb_ds_capstone_projects_2022
mkdir -p _static && \
    wget -nc -O _static/live.js https://livejs.com/live.js
jb build . && \
    python -m http.server --directory _build/html 2>/dev/null &
while inotifywait -re modify --exclude='_build' .
do 
    jb build .
done

Recommend Projects