Caroline open-source Python framework for interactive web/HTML-based science presentations
Project description
Caroline is open-source Python framework for interactive web/HTML+JS based science presentations. With Caroline you can show and annotate everything. Interface is minimalistic and focus is on content, as we stick to the principle that the best software is the one that you don't realize is there. Caroline blurs distinction between slides and whiteboard, between demonstration and derivation, and smoothly even crosses from one way lecturing to interacting with the audience, allowing real-time note-taking, quizzes and even all-to-all collaboration. With Caroline making flow of ideas smooth, we can now reimagine how lectures can look! Caroline is made specifically not just to impress the audience but to allow you to do everything you possibly can to reach "aha!" moment of understanding and inspiration, thanks to
-
Simple input: supports full markdown support, LaTeX, code highlighting, zoomable figures; shows blinking pointer when mouse/pen pressed...
-
Annotations textual or by drawing during lecture over anything (text, video, figure...)
-
Camera support: for lecturer view; multiple camera for experimental demonstrations
-
Interactive elements: interactive figures, 3D objects, movies, JavaScript simulations and other IFrames
-
Audience engagement: quizzes, Roundtable discussions and feedback, audience slide-copy supports annotations and exploration in parallel with a lecture
-
Simple portability, and a decluttered interface focused on really necessary: Works in any web browser (from PC to smart fridge), even offline (assuming that no online materials are added in IFrames). Presentation is defined with a human readable plain text file that can be easily versioned with git.
Example presentation that highlights Caroline's capabilities is available here. The link opens lecturer copy. To see audience copy, follow the link on the first opened slide, but keep lecturer copy open to control presentation and see audience-submitted responses.
Example of stand-alone Roundtable - surface for collaborative feedback - which is part of is available at https://roundtable.researchx3d.com as a public demo server. Roundtable can be accessed from within the Caroline framework also. When used as support during meetings (in-person, video conference or mixed), it is ideally viewed opened on horizontal tablet surface while keeping vertical surface for direct view of collaborators, keeping the usual geometry of in-person meetings.
Get started in 5 minutes
Start by installing Caroline package from calling Python pip (install Python first if you don't have it) from the command line :
pip install caroline-presentation
In the folder where you want to make your presentation run
python -m caroline.template
This creates a template presentation in the folder. Edit presentation by changing
presentation_code.py
in your favorite code editor. Save changes and run
python presentation_code.py
To open/preview a presentation open presentation.html
(or just refresh the page if it is already opened).
Alternatively, if you want to start from one full example of presentation, run
python -m caroline.example
To see other methods to start presentation that has support for interaction with the audience, or that is automatically pre-filled with material you have provided in a folder, please check ways to start a new presentation.
Name and logo
Caroline is named after Caroline Herschel (1750-1848) who was a pioneering astronomer and scientist. She had independent scientific career as a creator of New General Catalogue and discoverer of several comets, in addition to her work with her brother William Herschel (1738 -1822) early in her career. She was the first woman to receive a salary as a scientists, the first woman to hold a government position in England, the first woman to publish scientific findings in the Philosophical Transactions of the Royal Society.
The arrow and the line below Caroline name in the package's logo illustrate the aim of the package to show and annotate everything.
Roundtable is part of the Caroline framework, inspired by collaborative feedback sessions during supervision meetings. It is named after famous Round table of King Arthur, where everyone is equal, since when using Roundtable everyone can contribute, manipulate and annotate the content equally.
Authors & contributing
Developed by Nikola Šibalić, with encouragement, constructive feedback and early testing by Charles S. Adams.
If you like the Caroline, or Roundtable sub-project, please spread the word!
If you want to contribute to the project check contributing guidelines. Caroline is open-source, build with open-source stack of tools with aim to be flexible and adjustable.
License
All the files distributed with this program are provided subject to the BSD-3-Clause license. A copy of the license is provided.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file Caroline-presentation-0.3.1.tar.gz
.
File metadata
- Download URL: Caroline-presentation-0.3.1.tar.gz
- Upload date:
- Size: 42.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4a9f9f680f231c1aa1e7567cbc88c1d6630a61bb760bb70ffeb5a412188ec68d |
|
MD5 | 390f9cde3fbe8d17cb9fb262c2a63f9b |
|
BLAKE2b-256 | d8f1e74fee6dedcc171e98a0335c82f110dbe7f884e441f6be65fc82021add2b |