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