Package: nbslide
nbslideSlideshow extension for JupyterLab. This extension adds a presentation mode for Jupyter Lab that hides cells during a presentation to help the audience focus on the part that matters.In comparison toRISE,nbslideis a simpler extension that keeps the notebook look and feel and executes cells automatically during the presentation mode.Why did you make this?RISE is a great tool for general presentations, but the usage ofreveal.jsmakes it not look much like a notebook. I waspreparing a presentationthat introduces Jupyter and faced the dilemma of using RISE and losing the look of a notebook, or running the notebook directly and losing the focus of the audience.Additionally, I had made a similar extension forold jupyter notebooks beforewhen I faced the same dilemma in a previous presentation. Thus, I decided to port it to Jupyter Lab, extend it to support the configuration of Slides, and make it more generic.UsageFor configuring the Slideshow,nbslideuses thesame optionsin the "Cell Toolbar" as RISE. However, the types may have a slightly different behavior:slide: this cell is the beginning of a new slide (same behavior)subslide: this cell is also the beginning of a new slide, but displaying it hides everything up to (and including) its mainslide. It is useful for presenting changes on cells, since the default definition of slides displays them all sequentially.fragment: this cell can be part of a slide or a subslide. It is hidden at first glance, but becomes visible once you advance the slide (same behavior as RISE). Note that in our case the behavior is not much different than setting a cell as a newslide. However, afragmentis also hidden for the exihibition of asubslide.skip: this cell is ignored and never displayed during the presentation (same behavior as RISE).notes: currently,nbslidedoes not have a speaker view, so it is the same asskip.Additional configurationsIn addition to these cell types it is also possible to add tags to cells for additional behaviors:skiprun: prevents code cell from running during the slide displaynoscroll: prevents the notebook scroll to move to the cell during the slide displayFinally, it is also possible to include additional properties to the"slideshow"metadata in the cell:slide_title: defines the current slide title. By default, it uses the notebook name.slide_suffix: defines the suffix of the title. By default, it reads and updates from Header elements.slide_autosuffix: deactivate (and reactivate) the update of suffixes based on header elements.ShortcutsThe default shortcuts ofnbslideare also different than the ones from RISE. We borrow shortcuts from Google presentations/Powerpoint:Ctrl+F5: Start/Stop presentation in the current slide.Ctrl+Shift+F5: Start presentation from the first slide.Right Arrow: Move to the next slide. If it is hidden,nbslideexecutes all of its cells.Left Arrow: Hide current slide and go to the previous one.\: Display current slide withou trying to execute it. Note that it is possible to useDownandUparrows to navigate normally on the cells of the notebook, including the ones that are hidden.RequirementsJupyterLab >= 3.0InstallTo install the extension, execute:pipinstallnbslideUninstallTo remove the extension, execute:pipuninstallnbslideContributingFeel free to submit pull requests and open issues.Development installNote: You will need NodeJS to build the extension package.Thejlpmcommand is JupyterLab's pinned version ofyarnthat is installed with JupyterLab. You may useyarnornpmin lieu ofjlpmbelow.# Clone the repo to your local environment# Change directory to the nbslide directory# Install package in development modepipinstall-e.# Link your development version of the extension with JupyterLabjupyterlabextensiondevelop.--overwrite# Rebuild extension Typescript source after making changesjlpmrunbuildYou can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.# Watch the source directory in one terminal, automatically rebuilding when neededjlpmrunwatch# Run JupyterLab in another terminaljupyterlabWith the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).By default, thejlpm run buildcommand generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:jupyterlabbuild--minimize=FalseDevelopment uninstallpipuninstallnbslideIn development mode, you will also need to remove the symlink created byjupyter labextension developcommand. To find its location, you can runjupyter labextension listto figure out where thelabextensionsfolder is located. Then you can remove the symlink namednbslidewithin that folder.