rzmk/100.dathere.com

mirror of https://github.com/dathere/100.dathere.com.git synced 2025-12-18 16:19:26 +00:00

🧩 (WIP) The book "100 exercises with qsv". For new qsv users to read lessons and try out exercises either in-browser or locally in their terminal. Built with Jupyter Book.

bash binder cli csv data-engineering data-wrangling jupyter-book mybinder python qsv spreadsheet thebe

Find a file

rzmk 86f90af434 feat: initial commit for 100.dathere.com and first exercise		2024-05-29 09:03:38 -04:00
.github/workflows	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
.vscode	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
bash_kernel	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
lessons/0	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
media	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
.gitignore	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
_config.yml	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
_toc.yml	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
appendix.md	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
exercises-setup.md	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
intro.md	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
notes.md	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
postBuild	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
README.md	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00
requirements-local.txt	feat: initial commit for 100.dathere.com and first exercise	2024-05-29 09:03:38 -04:00

README.md

100.dathere.com

Try out available exercises: 100.dathere.com

This codebase includes source code for "100 exercises with qsv" found at 100.dathere.com.

How to run the Jupyter Book locally

Ensure you are using one of the following OS/software:

Windows Subsystem for Linux 2 (not Windows) running Ubuntu
macOS
Linux

Install the prerequisites:

Git
Visual Studio Code - Code editor
- Live Server extension - Local server extension (to view Jupyter Book locally and hot reload)
- Run on Save extension - Allows for auto-build on save for the file types specified in ../.vscode/settings.json
Python
uv - Python package manager

Clone the repository to your local device using Git:

git clone https://github.com/dathere/100.dathere.com.git

Change your directory into this folder book.
Run uv venv, this should generate a .venv folder.

On macOS and Linux
- Run source .venv/bin/activate
On Windows
- Run .venv\Scripts\activate

Run uv pip install -r requirements-local.txt.
Run uv pip install -e ./bash_kernel and then python -m bash_kernel.install to install the Bash kernel.
Run jb build . to build the book or save a .md, .ipynb, or .yml file in VS Code for the Run on Save extension to run relevant commands.
Right click on _build/html/index.html and click Open with Live Server which should launch a local build of the website and should reload within a few seconds each time you save a .md or .yml file in VS Code (you may need to refresh the page once Run on Save is done each time).