Package: rst2html5slides
rst2html5slidesrst2html5slides extendsrst2html5to translate a reStructuredText file
into a web presentation.RationalePresentations based on web frameworks such asimpress.js,jmpress.jsanddeck.jsare 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 designThey have new and great visual effects such as slide transitions and positional effectsA web presentation is portable. It runs on any modern browserOn 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 justifyreStructuredTextas 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,
thenrst2html5slidesis perfect for you to create your presentations.FeaturesCSS can be extended or overwritten by adding new stylesheets;Slides can be positioned manually or automatically through pre-defined functions
(linear,gridandgrid-rotate);Installationpipinstallrst2html5slidesBasic Usage$rst2html5slides[OPTIONS]SOURCE[DESTINATION]If no destination is given, then the presentation is written to thestdout.
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-idDisable 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.stepTipAllrst2html5options can be used withrst2html5slidessuch as--stylesheetand--script.Note--deck-selectorand--slide-selectorare only required for advanced usage.
See the full documentation for additional information.Examplesimple.rst:..title::Simple Presentation | rst2html5slides..meta:::author:André Felipe Dias..class::coverPresentation============Author------Topic 1=======*item A*item BTopic 2=======*item C*item DTo translate it to a  presentation located at/tmp/slides,
use this command:$rst2html5slidessimple.rst/tmp/slidesThe generated file is:<!DOCTYPE html><html><head><linkrel="stylesheet"href="css/slideshow.css"><scriptsrc="js/jquery.min.js"></script><scriptsrc="js/greensock/TweenMax.min.js"></script><scriptsrc="js/video_animation.js"defer></script><scriptsrc="js/slide_animations.js"defer></script><scriptsrc="js/slideshow.js"defer></script><metacharset="utf-8"/><metagenerator="rst2html5slides"/><metagenerator-homepage="https://pypi.python.org/pypi/rst2html5slides"/></head><body><deck><slideid="presentation"><header><h1>Presentation</h1><h2>Author</h2></header></slide><slideid="topic-1"><header><h1>Topic 1</h1></header><section><ul><li>item A</li><li>item B</li></ul></section></slide><slideid="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:cssjssimple.html/tmp/slides/css:slideshow.css/tmp/slides/js:greensockjquery.min.jsslide_animations.jsslideshow.jsvideo_animation.jsNoteYou can customize your presentation adding CSS files, scripts or
changing the default template.
See the full documentation for more information.DocumentationThe full documentation is available at readthedocs.org and also in thedocsubdirectory.Sourcerst2html5slides source is located athttp://bitbucket.org/andre_felipe_dias/rst2html5slidesLicenserst2html5slides is available under a MIT license.Changelog1.2.2 - 2018-11-17Fix setup.pyReorganize project structure1.2.1 - 2018-11-14Fix installation and dependencies1.2 - 2018-11-06Fix README.rstFix version exhibitionFix some PEP8 warningsFix tests comparing expected and obtained resultsrequirements.txt replaced by pipenvUpdate project to work with rst2htm5 1.9.51.1 - 2018-11-06Update project to work with rst2htm5 1.9.4Slideshow is based on GreenSock Animation Platform (GSAP)1.0 - 2014-09-21First public preview release