from IPython.display import display, Markdown

with open("./README.md", "r") as file:
  content = file.read() 
  fixed = content.replace("](./", "](https://github.com/okkema/notes/blob/main/") # Fix links
  display(Markdown(fixed))

notes

JupyterHub workspaces, pipelines, and hosting

Workspaces

Workspaces are a collection of notebooks and other resources that share common dependencies. See the documentation for more details on creating new workspaces.

Repositories

• notes - Meta workspace for this repository, hosts the README

Pipelines

Pipelines are run using GitHub Actions. Tags and releases are used to version actions for use in workspaces.

Actions

• publish-notebook - Executes and publishes notebooks to hosting

Workflows

• issues - Adds new issues to default project
• push-hosting - Builds worker with npm and runs terraform to deploy infrastructure
• push-notebooks - Used by workspaces to publish notebooks

Hosting

Rendered workspace notebooks are hosted using Cloudflare Workers, R2, and Zero Trust. Workspaces are responsible for rendering notebooks to HTML and uploading them to the correct location within the bucket.

Subdomains

• public - Publicly accessible notebooks
• private - Private notebooks accessible through Zero Trust