Skip to content

ProCode-Software/jupyter-slides

Repository files navigation

jupyter-slides

Jupyter Vue.js Go Vite TypeScript

🪐 A tool to convert Jupyter Notebooks to slide shows.

Features

  • 📖 Frontend written in Vue.js and TypeScript
  • 💻 Backend written in Go
  • 🖼️ Supports loading images
  • 📄 Fast Markdown parsing with markdown-it
  • 🎨 Code highlighting with Shiki with customizable theme

Installation

Go and pnpm are required

  1. Clone the repository
git clone https://github.com/ProCode-Software/jupyter-slides.git
cd jupyter-slides
  1. Run the ./install.sh script to build from source and install jupyter-slides into ~/.jupyter-slides. To install into a different location, run JS_DIR=folder ./install.sh

Usage

jupyter-slides [--port <port>] <notebook>
  • port: Localhost port number to host the server on
  • notebook: (Required) Path to Jupyter Notebook

Uninstallation

To uninstall jupyter-slides, just delete the ~/.jupyter-slides folder.

Development

Clone the repo:

git clone https://github.com/ProCode-Software/jupyter-slides.git
cd jupyter-slides
pnpm install
pnpm run dev

Create a notebook.ipynb file in the folder for testing. Then open http://localhost:5173 to view (this uses Vite's dev server).

License

MIT License

About

🪐 A tool to convert Jupyter Notebooks to slide shows.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published