jupyslides

A tool that allows you to display embedded slides in jupyter notebook. This is a simple widget to help you display your PPT / slides inside the jupyter notebook environment for better presentation experience.

How to install

You can install the package by typing this command in your terminal: pip install jupyslides.

How to use the package

• Step 1 - Export the PPT in image format

  The essential mechanism of this package is that you are displaying images instead of displaying the PPT itself. Therefore, the most critical step is to export your PPT in image format.

  Luckily, if you are working with Microsoft PowerPoint, you can export your PPT internally by clicking the following tabs in your PPT menu: File > Export... > File Format > PNG > Save Every Slide > Export. By doing so, PowerPoint will automatically generate a folder whose name is the same as your PPT file name. Inside this folder, each slide is exported as a .png image file. When exporting images, to maximize resolution, make Width=2999.

  Notice that, the name of each image file ends with a number - this is critical as it tells the tool the sequence of the slides, for example, Slide1.png, Slide2.png, Slide3.png etc. The slides will then be sorted in ascending order.

  Under any circumstance that PowerPoint does not generate these numbers, please manually add the number at the end of the file. Any file without a number in the end will be IGNORED. If you are not working with Microsoft PowerPoint, please make sure that you have fulfilled the above requirements.

• Step 2 - Initialization

  Starting from this step, you are assumed to have already exported your PPT in a folder with a bunch of images. Please make sure that you are aware of the path of this folder. If you are not sure where the folder is, you can cd into the PPT folder, and type the command pwd to check where it is located in your system.

  Below is the quickest way to initiate your slides

  from jupyslides import jupyslides

  You can adhere to the default dimension of your slides, which is width = 720px and height_to_width_ratio = 810/1080

  slides_path = 'path/to/your/PPT/folder'
  js = jupyslides(slides_path)

  You do have some level of control over the default size of the width of your slide, as well as the ratio between the height and width of your slides, you can make such customization by doing the following

  js = jupyslides(slides_path, 
                  default_width=1000, 
                  height_to_width_ratio=12/30)

• Step 3 - Slideshow

  As of now, you have initialized the slides already, the last step is to display the slides embedded in your jupyter notebook. The simplest method to showcase your embedded slides is

  js.slideshow()

  In this case, you are adhering to the default zoom-in, zoom-out and zoom-step factors. However, if you do want to have some control over the zooming feature, you can modify the parameters min_zoom, max_zoom and step_zoom.

  js.slideshow(min_zoom=0.2, max_zoom=3, step_zoom=0.1)

  That's it for the tutorial, if you have any questions, please contact me at nding17@outlook.com