asciidoctor / asciidoctor-reveal.js

:crystal_ball: A reveal.js converter for Asciidoctor and Asciidoctor.js. Write your slides in AsciiDoc!
http://asciidoctor.org
Other
287 stars 189 forks source link

Document that speaker notes will be displayed as plain-text when using a CDN (jsDeliver in particular) #500

Closed korve closed 1 year ago

korve commented 1 year ago

When i press s inside a reveal.js presentation the speaker view pops up. In this view the HTML is displayed as plain text and not rendered at all (See screenshot). The problem here seems to be that the CDN delivers the content as plain/text.

Versions:

Asciidoctor reveal.js 4.1.0 using Asciidoctor 2.0.18 [https://asciidoctor.org]
Runtime Environment (ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.x86_64-darwin22]) (lc:UTF-8 fs:UTF-8 in:UTF-8 ex:UTF-8)

Screenshot 2023-05-12 at 06 50 04

ggrossetie commented 1 year ago

Hey @korve this is a duplicate of https://github.com/asciidoctor/asciidoctor-reveal.js/issues/414

jsDeliver states that "serving HTML pages is not supported for security reasons". So you'd have to use a different CDN or publish through a hosting platform such as GitHub Pages, GitLab Pages, Netlify, etc.

ggrossetie commented 1 year ago

Feel free to submit a pull request to add a note in the documentation.

refaelsh commented 1 year ago

@korve Do you have the following line in your adoc file:

:revealjsdir: https://cdn.jsdelivr.net/npm/reveal.js@3.9.2

Or something to that effect?

ggrossetie commented 1 year ago

I've updated the title. This is not a bug, it's a limitation of jsDeliver for security reasons. Speaker notes will be displayed as plain-text when using jsDeliver. If you want to use speaker notes, you will need to use a self-hosted (or local) copy of reveal.js.

refaelsh commented 1 year ago

Feel free to submit a pull request to add a note in the documentation.

I will try it.