Clarify revealjs supported plugins list and attributes

[bcouetil]

Thank you again for this wonderful tool 🤗

I have a hard time figuring how to enable plugins.

First, the documentation speak about attributes that should be enable/disable and the example says disable[d].

Then we know that zoom and notes are there by default, and indeed, I see inclusion when debugging in browser :

Then I download revealjs, checkout the appropriate tag (3.9.2) maching my asciidoctor-revealjs version, list every plugin in the folder, and wild guess some attributes to test :

= Title

:revealjs_plugin_highlight: enabled
:revealjs_plugin_markdown: enabled
:revealjs_plugin_math: enabled
:revealjs_plugin_multiplex: enabled
:revealjs_plugin_print-pdf: enabled
:revealjs_plugin_search: enabled

== Chapter

But then only one more (markdown) seems to be activated :

Could the documentation be more precise on this point, please ? 🙏

[ggrossetie]

Version 4.1.0 has built-in support for zoom, notes and marked/markdown plugins:

asciidoctor-reveal.js/lib/asciidoctor-revealjs/converter.rb

Lines 201 to 213 in f8f549c

	def revealjs_dependencies(document, node, revealjsdir)
	dependencies = []
	dependencies << "{ src: '#{revealjsdir}/plugin/zoom-js/zoom.js', async: true }" unless (node.attr? 'revealjs_plugin_zoom', 'disabled')
	dependencies << "{ src: '#{revealjsdir}/plugin/notes/notes.js', async: true }" unless (node.attr? 'revealjs_plugin_notes', 'disabled')
	dependencies << "{ src: '#{revealjsdir}/plugin/markdown/marked.js', async: true }" if (node.attr? 'revealjs_plugin_marked', 'enabled')
	dependencies << "{ src: '#{revealjsdir}/plugin/markdown/markdown.js', async: true }" if (node.attr? 'revealjs_plugin_markdown', 'enabled')
	if (node.attr? 'revealjs_plugins') &&
	!(revealjs_plugins_file = (node.attr 'revealjs_plugins', '').strip).empty? &&
	!(revealjs_plugins_content = (File.read revealjs_plugins_file).strip).empty?
	dependencies << revealjs_plugins_content
	end
	dependencies.join(",\n ")
	end

reveal.js plugins system changed quite a bit in reveal.js 4: https://github.com/hakimel/reveal.js/tree/4.3.0/plugin

• highlight
• markdown
• math
• notes
• search
• zoom

In Asciidoctor reveal.js 5.0.0, we support the notes, search and zoom plugins.
Asciidoctor has already built-in support for STEM (using MathJax.js) and source highlighting using Highlight.js so there's no need to enable the math or highlight plugin.

We also decided to drop the markdown plugin since the content is already written in AsciiDoc (see #432).

Feel free to improve the 4.1 documentation by using the "Edit this Page" button on the top right corner.

We could also improve the documentation for 5.0.0: https://github.com/asciidoctor/asciidoctor-reveal.js/blob/master/docs/modules/converter/pages/revealjs-plugins.adoc by mentioning which plugins are supported and why markdown, highlight and math plugins are superfluous.

[bcouetil]

Thank you for your quick and detailed response.

I'll process this and will try to help on documenting this !