:crystal_ball: A reveal.js converter for Asciidoctor and Asciidoctor.js. Write your slides in AsciiDoc!
asciidoctor-chart by upgrading asciidoctor-templates-compiler to 0.7.0marked has been removed in reveal.js 4.0.0 and plugin markdown has been disabled.
As a result, the revealjs_plugin_markdown and revealjs_plugin_marked attributes have no effect anymore.revealjs_plugins and revealjs_plugins_configuration are replaced by Docinfo files.Before
presentation.adoc
= Third-party Plugins
:revealjs_plugins: examples/revealjs-plugins.js
:revealjs_plugins_configuration: examples/revealjs-plugins-conf.js
// ...
revealjs-plugin.js
{ src: 'revealjs-plugins/reveal.js-menu/menu.js' },
{ src: 'revealjs-plugins/chalkboard/chalkboard.js' }
revealjs-plugin-conf.js
menu: {
side: 'right',
openButton: false
},
keyboard: {
67: function() { RevealChalkboard.toggleNotesCanvas() },
66: function() { RevealChalkboard.toggleChalkboard() }
},
After
presentation.adoc
= Third-party Plugins
:docinfo: private
// ...
presentation-docinfo-footer.html
<script src="revealjs-plugins/menu/menu.js"></script>
<link rel="stylesheet" href="revealjs-plugins/chalkboard/style.css">
<script src="revealjs-plugins/chalkboard/plugin.js"></script>
<script>
Reveal.configure({
menu: {
side: 'right',
openButton: false
},
keyboard: {
67: function() { RevealChalkboard.toggleNotesCanvas() },
66: function() { RevealChalkboard.toggleChalkboard() }
}
})
Reveal.registerPlugin(RevealMenu)
Reveal.registerPlugin(RevealChalkboard)
</script>
:revealjs_plugin_search: enabled.path-parse from 1.0.6 to 1.0.7 in /test/js-babelpath-parse from 1.0.6 to 1.0.7glob-parent from 5.1.0 to 5.1.2lodash from 4.17.19 to 4.17.21 in /test/js-babely18n from 4.0.0 to 4.0.1thread_safe and concurrent-ruby dependenciesrevealjsdir can be a CDNThanks to the following people who contributed to this release:
Benno Bielmeier, Guillaume Grossetie, Julien Kirch, Marat Radchenko and Wei Cheng.
background-video attribute points to a file, that file is now looked up relative to the imagesdir document attribute.
This new behavior aligns with what images and video macros already did.
Existing slide decks using both imagesdir and background-video will need to move some files around.
See #356 for details.step attribute to control the display order of elements%step option can now be used on most blocksrevealjs_disablelayout attribute to disable layout (#381)set.
For instance: icon:font-awesome-flag[set=fab] (#393)font-awesome-version (#392)data- (#241)has-text-left, has-text-right and has-text-justified.
See #354 for details.mathjaxdir attribute to control where MathJax is loaded from (#350)text-left, text-right, text-center and text-justify (#380)autoslide attribute is now supported at the slide level (#367, #368)muted option for the video macro for YouTube and Vimeo (#358)background-video paths are now resolved using media_uri (#356)autoplay option fixed for YouTube and Vimeo videos (#357)asciidoctor-doctest to v2.0.0.beta.7git tag | full diff | milestone
Thanks to the following people who contributed to this release:
Adrian Kosmaczewski, Dan Allen, Guillaume Grossetie, Olivier Bilodeau and Romain Quinio.
Repackage for NPM.
A major release with a ton of improvements! All of reveal.js 3.8.0-3.9.2 new features are supported. Added a new set of column layout options for quick slides design. Highlight.js support improved. Easier templates customizations. New Java / JVM toolchain via AsciidoctorJ-reveal.js. Support was added for Asciidoctor docinfo and sectnums attributes, kbd macro and callout styles were fixed.
See the upgrade considerations section for the list of potentially breaking changes.
background-opacity to alter the opacity of the title slide no longer works. When the opacity feature was introduced we forgot to align with the other title slide attributes. The feature was introduced in 3.0.0 and the bug stayed in 3.1.0. Starting with 4.0.0 use title-slide-background-opacity instead. See issue #323 for details.<div> that wraps all slide content (everything except the slide title). This might impact custom CSS with strict child relationships. See issue #326 and PR #332 for details.highlightjs-languages attribute to add specific languages on demand. Depending on what type of code you were highlighting, you might need to add your language using that attribute. See #320 for details.docinfo attribute changed. We were previously injecting docinfo-header.html somewhere in the HTML <head>. Now, docinfo-revealjs.html goes last into the HTML <head>, docinfo-header-revealjs.html goes right before the first slide <section> and docinfo-footer-revealjs.html goes right after the last slide <section>. The new documentation is available here and the related tickets are #198 and #324.--template-dir or -T when using the Ruby command-line interface (#177, #318, #349)highlightjs-languages attribute. It can also be loaded locally or from a CDN of your choice. See issues #21, #319 and #320 for details.linenums attributehighlight attributedata-preview on links and images with link can be activated by using the preview and link_preview Asciidoctor attributes respectivelyhash, navigationMode, shuffle, preloadIframes, totalTime, minimumTimePerSlide, hideInactiveCursor, hideCursorTime, previewLinks (data-preview-link) and mobileViewDistance (#301)sectnums AsciiDoc attribute (#185, #317)docinfo support to Asciidoctor Bespoke (#198, #324)highlightjs-languages attribute from Asciidocotor (#319, #320)background-opacity title slide attribute renamed to title-slide-background-opacity (#323, #325)kdb macro to represent keyboard shortcuts (#276, #329)Fixed a regression with Font-Awesome brand icons, added a JavaScript CLI and standalone executables for Windows, Linux and macOS.
npx asciidoctor-revealjs (#308)An API breaking release for Asciidoctor.js users that brings a bright future of long term stability. New Reveal.js features supported: background opacity, background positions, and PDF export. AsciiDoc table options now supported. A big FontAwesome update. Many other little improvements and polish.
Special heads-up: we are already planning for another major release since Reveal.js 3.8 support will be considered a breaking change. They changed how it is loaded and requires a template change incompatible with Reveal.js 3.1-3.7.
With the arrival of Asciidoctor.js 2.0.0 you can now use a command line interface (CLI) just like with Asciidoctor Ruby:
$(npm bin)/asciidoctor -r @asciidoctor/reveal.js -b revealjs presentation.adoc
If you want to keep generating your reveal.js presentations using the Node.js API, you need to change the following code. Instead of:
var asciidoctorRevealjs = require('asciidoctor-reveal.js');
asciidoctorRevealjs.register()
Use:
var asciidoctor = require('@asciidoctor/core')()
var asciidoctorRevealjs = require('@asciidoctor/reveal.js')
asciidoctorRevealjs.register()
asciidoctor-reveal.js to @asciidoctor/reveal.js (#252, #291)reveal.js as converter/backend name in addition to revealjs (#253, #297)git tag | full diff | milestone
Thanks to the following people who contributed to this release:
@bentolor, @cgxeiji, @gquintana, @Mogztter, @obilodeau and Daniel Mulholland
A critical bugfix release due to an important user-facing bug.
reveal.js options in CamelCase to use the default value instead of one specified as an AsciiDoc attribute (#263, #267)Thanks to the following people who contributed to this release:
@bentolor, @Mogztter, @obilodeau