search

voila-dashboards / voila

Voilà turns Jupyter notebooks into standalone web applications
https://voila.readthedocs.io
Other
5.39k stars 501 forks source link

[reveal] Document mechanism for how to change slide type #1030

Open lumberbot-app[bot] opened 2 years ago

lumberbot-app[bot] commented 2 years ago

It seems that the way to specify that cell is a slide or a subslide, is by setting the slide_type property within the slideshow property of the cell's metadata. 

...
"metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
} 
...

I was only able to work this out by looking at the source of the included demo reveal.ipynb. It would be great to have this included in documentation to make this discoverable. This tool has the potential to become extremely useful, but this issue I fear is a big barrier to adoption.

Originally opened as voila-dashboards/voila-reveal#7 by @ned2, migration requested by @SylvainCorlay

lumberbot-app[bot] commented 2 years ago

@ned2 commented: Further to this, I didn't actually know how to edit cell metadata in Jupyer Lab and only worked out that there is a cell editor in the sidebar after a little bit if googling around. Perhaps this kind of screenshot could be helpful? Screenshot from 2020-05-17 16-32-07

lumberbot-app[bot] commented 2 years ago

@agoose77 commented: For those looking, there is a cell metadata section in the Advanced Tools panel in the cell toolbar pictured.

lumberbot-app[bot] commented 2 years ago

@mkcor commented: Hi @ned2,

You can find this kind of screenshot in this post: https://medium.com/@mjspeck/presenting-code-using-jupyter-notebook-slides-a8a3c3b59d67 (Walkthrough section), which the announcement post links to. Let me add it to the README!

lumberbot-app[bot] commented 2 years ago

@SylvainCorlay commented: Yes, we definitely need to improve this.