Skip to content

🧩 (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.

Notifications You must be signed in to change notification settings

dathere/100.dathere.com

Repository files navigation

100.dathere.com

Jupyter Book Badge

Try out available exercises: 100.dathere.com

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

100.dathere.com preview

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
  1. Install the prerequisites:
  1. Clone the repository to your local device using Git:
git clone https://github.com/dathere/100.dathere.com.git
  1. Change your directory into this folder book.
  2. Run uv venv, this should generate a .venv folder.
  • On macOS and Linux
    • Run source .venv/bin/activate
  • On Windows
    • Run .venv\Scripts\activate
  1. Run uv pip install -r requirements-local.txt.
  2. Run uv pip install -e ./bash_kernel and then python -m bash_kernel.install to install the Bash kernel.
  3. You may need to add qsv to your PATH first. Then, 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.
  4. Serve the build locally. For example using VS Code, 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). You may need to navigate to the proper URL such as http://localhost:5500/\_build/html/.

Live Server extension example

Notice

datHere and the maintainers of this repository are the current organizers of the book's content, and therefore may or may not merge pull requests and/or resolve issues/discussions at their discretion. If you need further assistance, please reach out at dathere.com/contact.


© Copyright datHere

datHere logo dark datHere logo light

About

🧩 (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.

Topics

Resources

Stars

Watchers

Forks