rst2html5slides generates a slideshow from a reStructuredText file.
Project description
rst2html5slides
rst2html5slides extends rst2html5 to translate a reStructuredText file into a web presentation.
Rationale
Presentations based on web frameworks such as impress.js, jmpress.js and deck.js are great alternatives to traditional software packages:
HTML, CSS and javascript files are plain text files and thus they are friendly to version control systems, making easy to follow and visualize their changes between revisions;
There is a separation between content and presentation design
They have new and great visual effects such as slide transitions and positional effects
A web presentation is portable. It runs on any modern browser
On the other hand, creating presentations directly in HTML is painful. A better approach is to use another markup language that is easier to read and write, and then translate the text to HTML.
I could have listed or cooked up a few reasons to justify reStructuredText as the best choice. The truth is that the best markup language is the one you already know. So, if you also use reStructuredText in other projects or contexts, then rst2html5slides is perfect for you to create your presentations.
Features
CSS can be extended or overwritten by adding new stylesheets;
Slides can be positioned manually or automatically through pre-defined functions (linear, grid and grid-rotate);
Installation
pip install rst2html5slidesBasic Usage
$ rst2html5slides [OPTIONS] SOURCE [DESTINATION]If no destination is given, then the presentation is written to the stdout. Else, the presentation and all related files (images, CSS, scripts etc.) are written into the specified path.
Options:
- --presentation=<framework>
Choose a web presentation framework for the output. Possible values are impress.js, jmpress.js, deck.js, None. Default is impress.js.
- --distribution=<function_name>
Specify the name of the slide distribution function. Options are “linear”, “grid” or “grid-rotate”. An additional parameter can be specified along with the name such as in “grid_rotate 3”.
- --increment=<increment>
Specify the value of the increment used by the distribution functions. To specify different values for X and Y increments, separate them by space. Example “1000 500”. Default value is 1600 for X and Y increments.
- --manual-slide-id
Disable slide automatic identification based on title.
- --deck-selector=<deck_selector>
Specify the tag, id and/or class to replace the default (and non-standard) <deck> tag used to surround the slides. Follow the pattern tag#id.class (such as a CSS selector). Examples: div, div#impress, div.deck- container, article#impress.impress-not-supported
- --slide-selector=<slide_selector>
Specify the tag, id and/or class to replace the default (and non-standard) <slide> tag used to surround each slide.Follow the pattern tag#id.class (such as a CSS selector)Examples: div.slide, section, div.step
Example
simple.rst:
.. title:: Simple Presentation | rst2html5slides
.. meta::
:author: André Felipe Dias
.. class:: cover
Presentation
============
Author
------
Topic 1
=======
* item A
* item B
Topic 2
=======
* item C
* item DTo translate it to a presentation located at /tmp/slides, use this command:
$ rst2html5slides simple.rst /tmp/slidesThe generated file is:
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="css/slideshow.css">
<script src="js/jquery.min.js"></script>
<script src="js/greensock/TweenMax.min.js"></script>
<script src="js/video_animation.js" defer></script>
<script src="js/slide_animations.js" defer></script>
<script src="js/slideshow.js" defer></script>
<meta charset="utf-8" />
<meta generator="rst2html5slides" />
<meta generator-homepage="https://pypi.python.org/pypi/rst2html5slides" />
</head>
<body>
<deck>
<slide id="presentation">
<header>
<h1>Presentation</h1>
<h2>Author</h2>
</header>
</slide>
<slide id="topic-1">
<header>
<h1>Topic 1</h1>
</header>
<section>
<ul>
<li>item A</li>
<li>item B</li>
</ul>
</section>
</slide>
<slide id="topic-2">
<header>
<h1>Topic 2</h1>
</header>
<section>
<ul>
<li>item C</li>
<li>item D</li>
</ul>
</section>
</slide>
</deck>
</body>
</html>rst2html5slides copies all referenced files (images, additional scripts and css) to the destination path:
$ ls -R /tmp/slides
/tmp/slides:
css js simple.html
/tmp/slides/css:
slideshow.css
/tmp/slides/js:
greensock jquery.min.js slide_animations.js slideshow.js video_animation.jsDocumentation
The full documentation is available at readthedocs.org and also in the doc subdirectory.
Source
rst2html5slides source is located at http://bitbucket.org/andre_felipe_dias/rst2html5slides
License
rst2html5slides is available under a MIT license.
Changelog
1.2.2 - 2018-11-17
Fix setup.py
Reorganize project structure
1.2.1 - 2018-11-14
Fix installation and dependencies
1.2 - 2018-11-06
Fix README.rst
Fix version exhibition
Fix some PEP8 warnings
Fix tests comparing expected and obtained results
requirements.txt replaced by pipenv
Update project to work with rst2htm5 1.9.5
1.1 - 2018-11-06
Update project to work with rst2htm5 1.9.4
Slideshow is based on GreenSock Animation Platform (GSAP)
1.0 - 2014-09-21
First public preview release
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 rst2html5slides-1.2.2.tar.gz.
File metadata
- Download URL: rst2html5slides-1.2.2.tar.gz
- Upload date:
- Size: 155.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.0 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 740dc708ee84c92a0c82a8568ea1b53da1f68b38080add11b5b5a2fa6d74763d |
|
| MD5 | 20bee0030b9c35def165cf57486c5ced |
|
| BLAKE2b-256 | 8bef28178ec89342ad2e9e4dfe273ee2fea60bb6b7f3203d6e7111f368b81f2c |
File details
Details for the file rst2html5slides-1.2.2-py2.py3-none-any.whl.
File metadata
- Download URL: rst2html5slides-1.2.2-py2.py3-none-any.whl
- Upload date:
- Size: 179.2 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.0 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d417782dfdb1ad3e6cd117670263d90e9b6bef1f6a08768a1c4ab85a94864248 |
|
| MD5 | ef05c6fc446996ede4b3a6e6b3eab1f5 |
|
| BLAKE2b-256 | 9ea2643e762d224c49677f84b07e0ca14af11702f0a538bca981b464bc40d072 |
