Have you ever wanted to create a slideshow using Python? I’ve found a lot of useful tools for making slideshows in Jupyter Notebooks while developing Python for data science workshops for the University of Cincinnati and 84.51°, but I’m yet to see all of this information in one place. This blog post changes that by directly teaching you how to create interactive slideshows in Jupyter Notebooks.
This post covers the benefits of using Python and Jupyter to create slideshows and how to set up the technology, create a slideshow, and view/operate the created slideshow.
Why to create slideshows in Python and Jupyter
Using Python and Jupyter Notebooks to create slideshows has many benefits:
- Version control your slideshows
- Make your slideshows dynamic
- Share your code in group settings
- Maintain a single analysis/presentation document
While there are many other benefits to using Python and Jupyter Notebooks to create, these reasons alone are rather convincing - especially given how easy creating the slideshows is.
What you need to already know
Creating slideshows is easy, but only if you know a few of the basics. This tutorial assumes you have a working knowledge of basic Python, Jupyter Notebooks, and the command line. In addition, it will be helpful to have experiences installing and working with Jupyter Notebooks extensions and Python packages.
If you don’t already have this knowledge, that’s alright - you should still be able to follow most of this tutorial if you have Python and Jupyter Notebooks installed.
How to set up the tech
Installing Python and Jupyter Notebooks
If you don’t already have Python and Jupyter Notebooks installed, the first thing you’ll need to do is install them. I recommend using Anaconda Navigator for a fast and easy setup. Anaconda’s installation instructions are easy to follow.
RISE, developed by Damian Avila, is the best slideshow engine I’ve found for Python and Jupyter Notebooks. It stands for Reveal.js IPython/Jupyter Slideshow Extension.
In order to install RISE, you’ll need to use the command line. If you’ve installed Anaconda, you can use:
conda install -c conda-forge rise
Otherwise, you can install with
pip install RISE
You won’t interact directly with RISE. Instead, you’ll be able to access it through Jupyter Notebooks.
How to create a slideshow
Enabling slideshow mode
In order to create a slideshow, you’ll need to start Jupyter Notebooks and open a new notebook (note that you must do this after you’ve installed RISE). Once you have a fresh Jupyter Notebook, you’ll need to enable the slideshow. You can do this by doing the following:
- Click on “View” in the Jupyter toolbar
- Hover over “Cell Toolbar” in the “View” menu
- Click on “Slideshow” in the “Cell Toolbar” menu
You’ve now enabled slideshow mode.
Creating the slides with cells
At this point, you should you a cell toolbar with a dropdown menu on the right-side:
You should see six options here. This dropdown and its options determine how each cell fits into the slideshow. These The options and their descriptions are below:
- slide - indicates that the selected cell should be the start of a new slide
- sub-slide - indicates that the selected cell should be the start of a new sub-slide, which appears in a new frame beneath the previous slide
- fragment - indicates that the selected cell should appear as a build to the previous slide
- skip - indicates that the selected cell should be skipped and not be a part of the slideshow
- notes - indicates that the selected cell should just be presenter notes
- - - indicates that the selected cell should follow the behavior of the previous cell, which is useful when a markdown cell and a code cell should appear simultaneously
Each of these options can include Python code or markdown/HTML/LaTeX code like a traditional Jupyter Notebook.
Viewing and operating the slideshow
Viewing the slideshow
Once cells have been used to create slide material for the slideshow, the slideshow can be viewed from directly within the notebook.
There are two options to view the slideshow:
- Using the OPTION + R shortcut (ALT + R on Windows) to enter and exit presentation mode from within the notebook
- Clicking the “Presentation Mode” button frmo within the notebook - this will only appear if you’ve installed RISE
After entering presentation mode, you should see a screen that looks like this:
This means the presentation is active.
Operating the slideshow
While it may be tempting to use the <- and -> keys to change slides in the slideshow, this will not fully work - it will skip the cells marked as sub-slides. Instead, SPACE should be used to move the slideshow forward and SHIFT + SPACE should be used to move the slideshow backward.
There are many other keyboard shortcuts that can be accesed within the slideshow by clicking the question mark in the bottom-left corner.
Running code and editing on-the-fly
One of the great things about RISE is that it work in a live Python session - that means you can edit and run code while the presentation is running!
If a code cell is marked as slide, sub-slide, fragment, or -, it will appear in the slideshow as editable and runnable. Here’s an example:
If you’re interested in learning more about creating slideshows in Jupyter, stay tuned for additional posts.
You can also view an example here of a training slideshow created using Python, Jupyter Notebooks, and RISE.