This release is a pre-release and may not be stable for production use.
IPySlides
Create Interactive Slides in Jupyter/Voila with all kind of rich content.
- Launch Example Notebook
- See a Demo Notebook at Kaggle
- See PDF-Slides
- See PDF-Report
Changelog
Above version 1.4.0, users can see upto date documentation via ipyslides.Slides().docs(), so no additional changelog will be created in future.
See old changelog
Install
> pip install ipyslides
> pip install ipyslides[extra]
For development install, clone this repository and then
> cd ipyslides
> pip install -e .
Jupyter Notebook version 7 is supported same way as Jupyter Lab in ipyslides >= 1.8.5
Creating Slides
Inside Jupyter Notebook:
#------------ Cell 1 --------------------
import ipyslides as isd
slides = isd.Slides(**settings_kwargs) # settings_kwargs are added in 1.4.1
slides.settings.set_animation(main='zoom') # can be changed per slide in 1.7.6+
slides.xmd_syntax # Gives you information what you can do with markdown 1.7.2+
#------------ Cell 2 --------------------
%%title
# create a rich content title page
#------------ Cell 3 --------------------
%%slide 1
# slide 1 content
#------------ Cell 4 --------------------
%%slide 1 -m # new in 1.4.6
Markdown here with extended options such as alert`this will be alerted in slides`. Nested blocks are not supported
```multicol 30 70
less content
+++
more content in ||side by || side columns||.
```
```python run source
x = 1 + 2
slides.write([x, source])
```
{{source}} will be shown in start here as well. Expressions are are not supported.
(1.8.9+) two dashes --- on their own line create multiple frames
#------------ Cell 5 --------------------
@slides.frames(1,*objs)
def func(obj):
write(obj) #This will create as many slides after the slide number 1 as length(objs)
#------------ Cell 6 --------------------
slides # This displays slides if on the last line of cell, or use `slides.show()`.
You can load slides from a markdown file
slides separator should be --- (three dashes) frames separator should be -- (two dashes)
slides.from_markdown(start, path)
with slides.slide(2):
write(slides[2].markdown) # write content of slide 2 from file
plot_something() # Add other things to same file
write_something()
You can see documentation slides with:
slides.docs()
You can see a rich content demo of slides with:
slides.demo()
Check out
slides.glassmorphicandslides.clipboard_imagein 2.0.1+.
You can build html of slides
Content type is limited. Widgets can not be exported.
slides.export.report() # >= 1.6
slides.export.slides() # HTML Slides
When exported to HTML and then PDF is printed, this gives a clean document.
Content Types to Embed
You can embed anything that you can include in Jupyter notebook like ipywidgets,HTML,PDF,Videos etc.,including jupyter notebook itself!
Note: Websites may refuse to load in iframe.
IPython Display Objects
Any object with following methods could be in write command:
_repr_pretty_, _repr_html_, _repr_markdown_, _repr_svg_, _repr_png_, _repr_jpeg_, _repr_latex_, _repr_json_, _repr_javascript_, _repr_pdf_
Such as IPython.display.<HTML,SVG,Markdown,Code> etc. or third party such as plotly.graph_objects.Figure.
Plots and Other Data Types (0.8.7+)
These objects are implemented to be writable in write command:
matplotlib.pyplot.Figure, altair.Chart, pygal.Graph, pydeck.Deck, pandas.DataFrame, bokeh.plotting.Figure.
Many will be extentended in future. If an object is not implemented, use display(obj) to show inline or use library's specific command to show in Notebook outside write.
Interactive Widgets
Any object in ipywidgets or libraries based on ipywidgtes such as bqplot,ipyvolume,plotly's FigureWidget
can be included in iwrite command. iwrite also renders other objects except Javascript.
Custom and Third Party Objects(not implemented in this library)
Starting version 1.6.1, you can add serialization method in current namespace. For example you can do something like this
@slides.serializer.register(int)
def colorize(obj):
color = 'red' if obj % 2 == 0 else 'green'
return f'<span style="color:{color};">{obj}</span>'
slides.write(*range(10))
# This will color even odd integers differently
Markdown Extensions
In 1.7.7+ you can install extensions of markdown e.g. PyMdown and use them as follows:
slides.extender.extend(extension)
Full Screen Presentation
-
Jupyterlab 3.0+ has full screen eneabled from any view:
-
Use Voila for full screen prsentations. Your notebook remains same, it is just get run by Voila, may not work as expected.
-
Slides in Jupyter Lab are theme aware in
Inherittheme mode, so theme of slides changes based on editor theme.
PDF printing
To include all type of objects you need to make PDF manually.
Read instructions in side panel about PDF printing. See PDF-Slides
If you just have HTML objects like matplotolib plots, images, plotly, bokeh charts etc. and not something like ipywidgets, see next section.
HTML/PDF Report/Slides [HTML Slides in 1.5.2+]
- You can create beautiful HTML/PDF report from slides using
slides.export.report. See PDF-Report - You can use CSS classes
.report-onlyand.slides-onlyto create different content for both sceberios. Content variety is limited. Widgets can not be exported. - Use
slides.export.slidesto build static slides that you can print as well. Widgets are not exported.
Speaker Notes (1.2.0+) (Experimental)
- You can turn on speaker notes with a
Show Notescheck in side panel. Notes can be added to slides usingslides.notes.insert(slides.notesin < 1.2.1) command. - Notes is an experimantal feuture, so use at your own risk. Do not share full screen, share a brwoser tab for slides and you can keep notes hidden from audience this way.
Known Limitations
- Slide number is necessary to be tracked by user in notebook, because cells are not linked to each other and multiple runs of a cell can lead to adding many slides with same content. In version
2.2.5+you can use propertySlides.AutoSlide().[title,slide,frames,from_markdown]inside Python script. - Bounding box of slides for screenshots should be set by user (if not in fullscreen).
Customize Slides
You can customize slides by inheriting from Slides class.
For example if you want to have custom theme and some other settings always enabled and
bottom information only on title slide, you can do so:
class CustomSlides(isd.Slides):
def __init__(self):
super().__init__()
self.settings.theme_dd.value = 'Custom'
self.progress_slider.observe(self.set_visible, names=['index'])
def set_visible(self, change):
if self.progress_slider.index == 0:
self.widgets.footerbox.layout.visibility = 'visible'
else:
self.widgets.footerbox.layout.visibility = 'hidden'
Very thankful to Python-Markdown which enabled to create
writecommand as well as syntax highliting.
1 maintainer
Metadata
1 maintainer
Release files for ipyslides 2.3.2rc1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ipyslides-2.3.2rc1.tar.gz | 6.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ipyslides-2.3.2rc1-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 112.0 kB
Release files / ipyslides-2.3.2rc1.tar.gz
| Download URL | ipyslides-2.3.2rc1.tar.gz |
|---|---|
| Size | 6.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
210929a177435847242d0904afb186e6f91ca2c78d285673fea51cedc92fc6e5
|
|
BLAKE2b-256 checksum How to use checksums |
b190966b08b5e2a1122f54f291cae77ddc5dae8f16f117d5ac8bef39a9e4161d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/65.3.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6
|
Release files / ipyslides-2.3.2rc1-py2.py3-none-any.whl
| Download URL | ipyslides-2.3.2rc1-py2.py3-none-any.whl |
|---|---|
| Size | 105.4 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
9c64789cac60109a9534784ce74a1b9ad0879077995172d190293f1c25116e6d
|
|
BLAKE2b-256 checksum How to use checksums |
aba8c1ece91abf72cdcb5e7778edd77e3a40db9123809889c8aa1d732fc9ab3b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/65.3.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6
|
