A Python-powered slideshow maker with steroids.
Project description
Auditorium
A Python-powered slideshow creator with steroids.
See the demo at auditorium-demo.apiad.net.
What's this about
Auditorium is a Python-powered slideshow generator. You write pure Python code, and obtain an HTML+JavaScript slideshow (using the amazing reveal.js library). The awesomeness comes from the fact that your Python backend is connected to the slideshow frontend, which allows your slideshow to dynamically change according to user input or automatically.
This opens the door to a few interesting use cases:
- The slides content itself can be generated by code. For example, long and repetitive sets of slides can be automatically generated, or tables and graphs embedded in slides can be generated on-the-fly with
matplotlib
,bokeh
,altair
,plotly
, or any visualization package that produces HTML output. - You can insert components in the slides that respond to user input, and execute a Python code in response. For example, you can generate an interactive graph that can be modified by moving sliders in a slideshow.
- You can create beautiful animations with simple Python code, that automatically play on a slide, using visualization libraries or simple HTML markup.
And all of this without writing a single line of HTML or JavaScript.
Alternatively, if you need little to no Python code, you can author your slideshow in pure Markdown and add some Python sprinkless here and there when necessary.
Installation
Simply run:
pip install auditorium[server]
To see a quick demo run:
auditorium demo
And point your browser at localhost:6789.
Quick Start and Tutorials
If you want to quickly grok auditorium
, the best option is to look at the demo online and then
read the source code. This way you will both see the end result and what effort it takes to get there.
- Authoring a slideshow with Python
- Authoring a slideshow with Markdown
- Rendering a slideshow as purely static HTML
- Hosting a slideshow online for free
Made with Auditorium
- Auditorium Demo - a slideshow showcasing the most important features from
auditorium
.
Your Contributions Here
If you have a slideshow to showcase here, feel free to edit this Readme and send a pull request. Add your website, Github repository, and any other information.
If you feel like sending some support please consider adding a badge somewhere in your website or repository:
<a href="https://apiad.net/auditorium">
<img alt="Made with Auditorium"
src="https://img.shields.io/badge/made--with-auditorium-blue">
</img>
</a>
It looks like this:
History
See the docs.
Collaboration and License
License is MIT, so you know the drill: fork, develop, add tests, pull request, rinse and repeat. See collaboration details in the docs.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file auditorium-20.2.1.tar.gz
.
File metadata
- Download URL: auditorium-20.2.1.tar.gz
- Upload date:
- Size: 2.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.0.3 CPython/3.8.0 Linux/4.15.0-1028-gcp
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2b2b79d8b9b665528f02e8642729d598fa8263097598bd96a9e9d178f44ed7d1 |
|
MD5 | fe99d74cb26a9870cdb97611b55811d3 |
|
BLAKE2b-256 | 5ba700cfa1712bf0b23dfe061cc55d3dda3888ad24348d8b6affcfbef2450ea3 |
File details
Details for the file auditorium-20.2.1-py3-none-any.whl
.
File metadata
- Download URL: auditorium-20.2.1-py3-none-any.whl
- Upload date:
- Size: 2.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.0.3 CPython/3.8.0 Linux/4.15.0-1028-gcp
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0730da2076bcd029810273767d9640d4e333df1859ff0d94e875af050f95669f |
|
MD5 | 4776c76fc3957318ada9dbb87fe6a42e |
|
BLAKE2b-256 | fa8c167cfd3eb04bd3f69041128093fcb88d7e410bba4290f80bcabf28cf67c6 |