====== revealjs Plugin ====== ---- plugin ---- description: Converts a DokuWiki page into a Reveal.js slideshow author : Emmanuel Klinger, Ottmar Gobrecht email : emmanuel.klinger@gmail.com, ottmar.gobrecht@gmail.com type : render syntax lastupdate : 2020-05-27 compatible : elenor of tsort, hrun, detritus, frusterick manners, greebo depends : conflicts : similar : s5, s5reloaded, impressjs tags : slideshow, presentation, javascript downloadurl: https://github.com/neuralyzer/dokuwiki-plugin-revealjs/zipball/master bugtracker : https://github.com/neuralyzer/dokuwiki-plugin-revealjs/issues sourcerepo : https://github.com/neuralyzer/dokuwiki-plugin-revealjs donationurl: screenshot_img : ---- This plugin creates [[https://github.com/hakimel/reveal.js/|reveal.js]] presentations from DokuWiki pages. Many reveal.js features such as themes and PDF export are also supported. The documentation is maintained on Github: [[https://github.com/neuralyzer/dokuwiki-plugin-revealjs/blob/master/README.md|DokuWiki plugin reveal.js documentation]]. ===== Installation ===== Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually. === Change Log === * **2018-09-02** * Fix problems with Greebo Release. Contributed by Jochen Metzger (https://github.com/jmetzger) * **2017-02-05** * Major update with all the work done by Ottmar Gobrecht (, https://github.com/ogobrecht) * Improved slide handling: Since slides are indicated by headers you are relative inflexible regarding the header levels and sizes on vertical (nested) slides - they are normally simply to small * New conf option horizontal_slide_level: Headers on this level or above starting a horizontal slide. Levels below starting a vertical (nested) slide - no effect on slides, which are indicated by alternative slide indicators * New conf option enlarge_vertical_slide_headers: Increase headers on slides below horizontal_slide_level - no effect on slides, which are indicated by alternative slide indicators * New alternative slide indicator: * ''---->'' opens a new slide with default transition in default speed (open previous slides will be closed implicitly) * Full example - parameters are parsed dynamically like in CSS, the parameter order is not important: ''---- orange wiki:dokuwiki-128.png 10% repeat bg-slide zoom-in fade-out slow no-footer ---->'' * All possible HTML color names and codes are supported: ''red'', ''#f00'', ''#ff0000'', ''rgb(255,0,0)'', ''rgba(255,0,0,0.5)'', ''hsl(0,100%,50%)'', ''hsla(0,100%,50%,0.5)'' * Background images are recognized case insensitive by the endings gif, png, jpg, jpeg, svg * Background image size is recognized by postfix ''%'' and ''px'' or by keywords ''auto'', ''contain'' and ''cover'' (cover is the default in Reveal.js) - example: ''10%'' or ''250px'' * Background image position is recognized by keywords ''top'', ''bottom'', l''eft'', ''right'', ''center'' (center is the default in Reveal.js) - examples: ''top left'', ''bottom center'' * Background image repeat is recognized by the keyword ''repeat'' (no-repeat is the default in Reveal.js) * Background transition: prefix ''bg-'' followed by ''none'', ''fade'', ''slide'', ''convex'', ''concave'' or ''zoom'' * Slide transition: ''none'', ''fade'', ''slide'', ''convex'', ''concave'' or ''zoom'' followed by optional postfix ''-in'' or ''-out'' for different transitions on one slide * Transition speed: ''default'', ''fast'', ''slow'' * ''---->>'' opens a new slide container for vertical (nested) slides and a new slide with the given options - example: ''---- red zoom ---->>'' * The next ''---->>'' will close the previous container (and slide) implicitly * Technical details: * In the rendering the slide mode changes from "headers driven" to "special horizontal rule driven" - headers are no longer interesting in this mode for slide changes * You can create of course a whole presentation with this alternative slide indicator * if you want to leave this slide mode you need a way to explicit close a slide or container: * ''<<----'' closes a slide container (and possibly open slide inside) * ''<----'' closes a slide * Improved existing background indicator: ''{{background>orange bg-zoom}}'' * allowing now all options from the new slide indicator (see above) * Improved wiki page rendering: * New conf option show_slide_details (default on): Show slide details on wiki page: start of slide and options, background preview, start of notes * Improved section editing: * Slide background definition or alternative slide indicators must be noted before the headers/slide content * The normal section editing has the problem, that it is starting on the headers, so the background definition or alternative slide indicators are on the wrong section * With the section editing improvement the whole slide can be edited at once including the background definitions * New conf option for the start button: * You can now select between the default one(start_button.png), the one from the s5 plugin (start_button.screen.png) and an own one (start_button.local.png), which is upgrade safe and must be copied into the plugin directory * If you are able to edit the page, then a export to PDF link is rendered under the start slideshow button - this is the reveal.js default export and works only in Chromium and Chrome - more infos [[https://github.com/hakimel/reveal.js#pdf-export|here]] * Introducing new syntax for [[https://github.com/hakimel/reveal.js#speaker-notes|speaker notes]]: * '''' - no parameters * No changes on wiki pages * On a slideshow the content is wrapped into ''