Skip to content
This repository was archived by the owner on Jul 28, 2024. It is now read-only.

fferegrino/presentpy-pptx

Repository files navigation

PresentPy

Create slides from Jupyter Notebooks

PresentPy allows you to take your Jupyter Notebooks and turn them into PowerPoint slides that then can be integrated into your presentation decks.

Installation

I strongly recommend using pipx to install PresentPy:

pipx install presentpy

Otherwise, you can install it using pip or your favorite package manager – the package is called presentpy.

Usage

To turn a notebook into slides, simply run:

presentpy [OPTIONS] nb NOTEBOOK_PATH

It also works with Python scripts:

presentpy [OPTIONS] py SCRIPT_PATH

Code configuration

You can configure the code cells to be displayed in the slides by adding a comment on the last line of the cell. The comment should start with #% and then you can add the following options:

  • title: The title of the slide
  • highlights: A comma separated list of lines to highlight, each highlight could be a number or a range of lines separated by a dash, e.g. 1,3-6,6-7

For example, take the following code:

def compute_hcf(x, y):
    if x > y:
        smaller = y
    else:
        smaller = x
    for i in range(1, smaller+1):
        if((x % i == 0) and (y % i == 0)):
            hcf = i 
    return hcf
#% title="Find the H.C.F of two numbers" highlights=1,2-3,4-5,9

The code above will generate 5 slides showing the same code but highlighting different lines in each slide – see how it looks below:

<iframe src="https://docs.google.com/presentation/d/e/2PACX-1vSOMEZNqOr9F3sNAxuqGvZAPMWlaRDqmc94NIOPDEzHTM8jzZ7vEAmeMZoR-o5-ZA/embed?start=false&loop=false&delayms=3000" frameborder="0" width="1280" height="449" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe>

You can then use these slides in your presentation deck.