search

asciidoctor / asciidoctor.org

:globe_with_meridians: Asciidoctor project site. Composed in AsciiDoc. Baked with Awestruct.
https://asciidoctor.org
Other
323 stars 803 forks source link

slideshow example is broken and recommends deckjs #765

Closed 0xaf1f closed 6 years ago

0xaf1f commented 6 years ago

at http://asciidoctor.org/docs/user-manual/#backend-and-deck-js-installation, it reads

Download or git clone the Asciidoctor backends repository.

$ git clone git://github.com/asciidoctor/asciidoctor-backends.git

but then building the example presentation later gives this error:

/usr/lib/ruby/vendor_ruby/asciidoctor/converter/composite.rb:52:in `find_converter': Could not find a converter to handle transform: document (RuntimeError)

and it turns out that a deck.js presentation should be using https://github.com/asciidoctor/asciidoctor-deck.js instead of https://github.com/asciidoctor/asciidoctor-backends.

Now, I'm not sure if you just want to change the link, or if you want to also add a pointer to asciidoctor-backends as a reference for other non-deck.js slideshows.

mojavelinux commented 6 years ago

I actually have plans to remove the deckjs information from asciidoctor.org. deckjs is not the recommended slideshow to use with Asciidoctor and I don't want to advertise it on asciidoctor.org. We recommend using either bespoke or reveal.js.

0xaf1f commented 6 years ago

Maybe until that gets updated, I'd suggest putting a little notice or a link to this issue in that tutorial so that new people coming to learn about Asciidoctor slideshows don't fall into the same hole I did.

mojavelinux commented 6 years ago

Those pages are now purged.