asciidoctor-revealjs 3.1.0 → 4.1.0.rc4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (89) hide show
  1. checksums.yaml +4 -4
  2. data/README.adoc +328 -55
  3. data/Rakefile +30 -7
  4. data/asciidoctor-revealjs.gemspec +5 -3
  5. data/examples/a11y-dark.css +99 -0
  6. data/examples/autoslide.adoc +22 -0
  7. data/examples/custom-layout.adoc +10 -0
  8. data/examples/data-attributes.adoc +245 -0
  9. data/examples/docinfo-footer-revealjs.html +10 -0
  10. data/examples/docinfo-revealjs.html +7 -0
  11. data/examples/font-awesome-specific-version.adoc +11 -0
  12. data/examples/font-awesome.adoc +18 -3
  13. data/examples/font-awesome.css +3 -0
  14. data/examples/footnotes.adoc +46 -0
  15. data/examples/fragments.adoc +44 -0
  16. data/examples/fragments.css +18 -0
  17. data/examples/grid-layout-3x2.adoc +50 -0
  18. data/examples/grid-layout-docinfo-revealjs.html +11 -0
  19. data/examples/grid-layout.adoc +194 -0
  20. data/examples/history-hash.adoc +19 -0
  21. data/examples/history-regression-tests.adoc +0 -5
  22. data/examples/history.adoc +4 -4
  23. data/examples/images/asciidoctor-logo.svg +102 -0
  24. data/examples/images/cute-cat-1.jpg +0 -0
  25. data/examples/images/cute-cat-2.jpg +0 -0
  26. data/examples/images/cute-cat-3.jpg +0 -0
  27. data/examples/images/flock-of-seagulls_daniel-simion.mp3 +0 -0
  28. data/examples/issue-grid-layout-images.adoc +25 -0
  29. data/examples/level-sectnums.adoc +24 -0
  30. data/examples/links-preview.adoc +32 -0
  31. data/examples/links.adoc +39 -0
  32. data/examples/mathjax-cdn.adoc +21 -0
  33. data/examples/mathjax.adoc +20 -0
  34. data/examples/release-4.0.adoc +192 -0
  35. data/examples/release-4.0.css +23 -0
  36. data/examples/release-4.1.adoc +133 -0
  37. data/examples/release-4.1.css +50 -0
  38. data/examples/revealjs-custom-theme.adoc +10 -0
  39. data/examples/source-coderay.adoc +15 -0
  40. data/examples/source-emphasis.adoc +128 -0
  41. data/examples/source-highlightjs-html.adoc +1 -1
  42. data/examples/source-highlightjs-languages.adoc +27 -0
  43. data/examples/source-highlightjs.adoc +85 -2
  44. data/examples/source-pygments.adoc +12 -0
  45. data/examples/source-rouge-docinfo.html +8 -0
  46. data/examples/source-rouge.adoc +18 -0
  47. data/examples/steps.adoc +87 -0
  48. data/examples/text-alignments.adoc +44 -0
  49. data/examples/video.adoc +30 -8
  50. data/examples/with-docinfo-shared.adoc +13 -0
  51. data/lib/asciidoctor-revealjs/converter.rb +1053 -770
  52. data/lib/asciidoctor-revealjs/highlightjs.rb +333 -2
  53. data/lib/asciidoctor-revealjs/version.rb +1 -1
  54. data/templates/admonition.html.slim +1 -1
  55. data/templates/asciidoctor-compatibility.css +390 -0
  56. data/templates/audio.html.slim +1 -1
  57. data/templates/colist.html.slim +1 -1
  58. data/templates/dlist.html.slim +3 -3
  59. data/templates/document.html.slim +76 -60
  60. data/templates/example.html.slim +1 -1
  61. data/templates/helpers.rb +170 -5
  62. data/templates/image.html.slim +3 -3
  63. data/templates/inline_anchor.html.slim +6 -4
  64. data/templates/inline_button.html.slim +2 -1
  65. data/templates/inline_footnote.html.slim +11 -4
  66. data/templates/inline_image.html.slim +5 -8
  67. data/templates/inline_kbd.html.slim +3 -2
  68. data/templates/inline_menu.html.slim +4 -3
  69. data/templates/inline_quoted.html.slim +13 -21
  70. data/templates/listing.html.slim +15 -10
  71. data/templates/literal.html.slim +1 -1
  72. data/templates/olist.html.slim +2 -2
  73. data/templates/open.html.slim +3 -3
  74. data/templates/paragraph.html.slim +1 -1
  75. data/templates/quote.html.slim +1 -1
  76. data/templates/section.html.slim +51 -43
  77. data/templates/sidebar.html.slim +1 -1
  78. data/templates/stem.html.slim +1 -1
  79. data/templates/stretch_nested_elements.js.slim +65 -0
  80. data/templates/table.html.slim +3 -2
  81. data/templates/title_slide.html.slim +28 -0
  82. data/templates/ulist.html.slim +3 -3
  83. data/templates/verse.html.slim +1 -1
  84. data/templates/video.html.slim +14 -8
  85. metadata +79 -16
  86. data/CHANGELOG.adoc +0 -456
  87. data/HACKING.adoc +0 -404
  88. data/examples/revealjs-features.adoc +0 -23
  89. data/templates/asciidoctor_revealjs.css.slim +0 -59
@@ -0,0 +1,19 @@
1
+ // .hash
2
+ // Enables reveal.js hash feature which is good to reload in-progress slides and doesn't push to browser history.
3
+ // :include: //body/script | //div[@class="slides"]
4
+ // :header_footer:
5
+ = No History
6
+ :backend: revealjs
7
+ :revealjs_hash: true
8
+
9
+ == First slide
10
+
11
+ This Deck
12
+
13
+ == Second slide
14
+
15
+ You can reload anytime
16
+
17
+ == Third slide
18
+
19
+ Yet browser history is not spammed
@@ -42,8 +42,3 @@
42
42
  == hello こんにちは
43
43
 
44
44
  == hello 你好
45
-
46
- [id=xss" onClick="javascript:alert('xss-ed')]
47
- == hello XSS
48
-
49
- security?
@@ -1,5 +1,5 @@
1
1
  // .history
2
- // Enables Reveal.JS' browser history feature
2
+ // Enables reveal.js' browser history feature
3
3
  // :include: //body/script | //div[@class="slides"]
4
4
  // :header_footer:
5
5
  = History
@@ -8,12 +8,12 @@
8
8
 
9
9
  == First slide
10
10
 
11
- Uno
11
+ This
12
12
 
13
13
  == Second slide
14
14
 
15
- Dos
15
+ Pushes
16
16
 
17
17
  == Third slide
18
18
 
19
- Tres
19
+ To Browser History Stack
@@ -0,0 +1,102 @@
1
+ <?xml version="1.0" encoding="UTF-8" standalone="no"?>
2
+ <!-- Created with Inkscape (http://www.inkscape.org/) -->
3
+
4
+ <svg
5
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
6
+ xmlns:cc="http://creativecommons.org/ns#"
7
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
8
+ xmlns:svg="http://www.w3.org/2000/svg"
9
+ xmlns="http://www.w3.org/2000/svg"
10
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
11
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
12
+ width="105.83333mm"
13
+ height="105.83333mm"
14
+ viewBox="0 0 105.83333 105.83333"
15
+ version="1.1"
16
+ id="svg3751"
17
+ inkscape:export-filename="/tmp/asciidoctor-logo-fill-color.png"
18
+ inkscape:export-xdpi="240"
19
+ inkscape:export-ydpi="240"
20
+ inkscape:version="0.92.2 (5c3e80d, 2017-08-06)">
21
+ <title
22
+ id="title4527">Asciidoctor</title>
23
+ <defs
24
+ id="defs3745" />
25
+ <sodipodi:namedview
26
+ id="base"
27
+ pagecolor="#ffffff"
28
+ bordercolor="#666666"
29
+ borderopacity="1.0"
30
+ inkscape:pageopacity="0.0"
31
+ inkscape:pageshadow="2"
32
+ inkscape:zoom="1.6245048"
33
+ inkscape:cx="-46.777153"
34
+ inkscape:cy="24.966208"
35
+ inkscape:document-units="mm"
36
+ inkscape:current-layer="layer1"
37
+ showgrid="false"
38
+ fit-margin-top="0"
39
+ fit-margin-left="0"
40
+ fit-margin-right="0"
41
+ fit-margin-bottom="0"
42
+ inkscape:window-width="3200"
43
+ inkscape:window-height="1658"
44
+ inkscape:window-x="0"
45
+ inkscape:window-y="68"
46
+ inkscape:window-maximized="1" />
47
+ <metadata
48
+ id="metadata3748">
49
+ <rdf:RDF>
50
+ <cc:Work
51
+ rdf:about="">
52
+ <dc:format>image/svg+xml</dc:format>
53
+ <dc:type
54
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
55
+ <dc:title>Asciidoctor</dc:title>
56
+ <dc:publisher>
57
+ <cc:Agent>
58
+ <dc:title>Asciidoctor</dc:title>
59
+ </cc:Agent>
60
+ </dc:publisher>
61
+ <dc:description>Asciidoctor project logo.</dc:description>
62
+ <dc:subject>
63
+ <rdf:Bag>
64
+ <rdf:li>AsciiDoc</rdf:li>
65
+ </rdf:Bag>
66
+ </dc:subject>
67
+ <dc:relation>https://asciidoctor.org</dc:relation>
68
+ </cc:Work>
69
+ </rdf:RDF>
70
+ </metadata>
71
+ <g
72
+ inkscape:label="Layer 1"
73
+ inkscape:groupmode="layer"
74
+ id="layer1"
75
+ transform="translate(-0.083335,-191.08337)">
76
+ <path
77
+ inkscape:connector-curvature="0"
78
+ id="path907"
79
+ d="m 26.240746,191.08337 c -14.436702,0 -26.157411,11.7201 -26.157411,26.15666 v 53.51951 c 0,14.43654 11.720957,26.15715 26.157411,26.15715 H 79.76025 c 14.436679,0 26.15641,-11.72061 26.15641,-26.15715 v -53.51951 c 0,-14.43656 -11.719488,-26.15666 -26.15641,-26.15666 z"
80
+ style="clip-rule:evenodd;fill:#e40046;fill-opacity:1;fill-rule:evenodd;stroke-width:0.24752024;stroke-linejoin:round;stroke-miterlimit:1.41420996" />
81
+ <path
82
+ style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:4.46009064px;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
83
+ d="m 55.70942,210.48548 a 2.2302684,2.2302684 0 0 0 -2.015517,1.37263 l -13.327365,32.05565 a 2.2302684,2.2302684 0 1 0 4.117839,1.71171 l 11.25217,-27.06706 23.600261,57.54395 a 2.2302684,2.2302684 0 1 0 4.125976,-1.69271 L 57.814455,211.86894 a 2.2302684,2.2302684 0 0 0 -2.105035,-1.38346 z"
84
+ id="path909"
85
+ inkscape:connector-curvature="0" />
86
+ <path
87
+ inkscape:connector-curvature="0"
88
+ id="path911"
89
+ d="m 36.817184,255.95416 a 2.2302685,2.2302685 0 0 0 -2.024151,1.40272 l -7.083967,17.04249 a 2.2302685,2.2302685 0 1 0 4.118502,1.71234 l 7.083967,-17.0425 a 2.2302685,2.2302685 0 0 0 -2.094351,-3.11505 z"
90
+ style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4.46009111px;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:1.5;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1" />
91
+ <path
92
+ style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:4.46009111px;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
93
+ d="m 21.548721,254.55016 a 2.2302685,2.2302685 0 1 0 0,4.45963 h 25.754124 a 2.2302685,2.2302685 0 1 0 0,-4.45964 z"
94
+ id="path915"
95
+ inkscape:connector-curvature="0" />
96
+ <path
97
+ style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:4.46009111px;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
98
+ d="m 26.263348,243.9626 a 2.2302685,2.2302685 0 1 0 0,4.45962 h 25.751411 a 2.2302685,2.2302685 0 1 0 0,-4.45962 z"
99
+ id="path919"
100
+ inkscape:connector-curvature="0" />
101
+ </g>
102
+ </svg>
@@ -0,0 +1,25 @@
1
+ // .issue-grid-layout-images
2
+ // Images would get shrunk before we added a flex-basis auto exception when columns wrap
3
+ // :include: //div[@class="slides"]
4
+ // :header_footer:
5
+ = Grid Wrapping Tests
6
+ :imagesdir: images/
7
+ // reveal.js config
8
+ :revealjs_hash: true
9
+ :revealjs_center: false
10
+ :revealjs_height: 1080
11
+ :revealjs_width: 1920
12
+
13
+ [.columns.wrap]
14
+ == Should Wrap But Doesn't
15
+
16
+ [.column]
17
+ * Things here should wrap
18
+ * But instead images shrink
19
+ * But now it's good
20
+
21
+ [.column]
22
+ image::cover.jpg[width=900px]
23
+
24
+ [.column]
25
+ image::70s.jpg[width=900px]
@@ -0,0 +1,24 @@
1
+ // .sections
2
+ // Demonstration of section numbers and their specific reveal.js integration.
3
+ // :include: //div[@class="slides"]
4
+ // :header_footer:
5
+ = Sectnums
6
+ :backend: revealjs
7
+ :sectnums:
8
+ :sectnumlevels: 2
9
+
10
+ == First level
11
+
12
+ First content
13
+
14
+ == Vertical
15
+
16
+ Vertical slides are using level 2 sections
17
+
18
+ === Level 2
19
+
20
+ ==== Level 3 does not have sectnum, sectnumlevels is 2
21
+
22
+ == Horizontal slide
23
+
24
+ === Also supports levels
@@ -0,0 +1,32 @@
1
+ // .links-with-preview
2
+ // Demonstration of reveal.js global data-preview-link feature
3
+ // :include: //div[@class="slides"] | //body/*[last()-1]
4
+ // :header_footer:
5
+ = Links With Preview Tests
6
+ :revealjs_previewlinks: True
7
+ :imagesdir: images/
8
+
9
+ == Set Globally
10
+
11
+ https://en.wikipedia.org/wiki/February_4[Here's a link]
12
+
13
+ == Disabled Locally
14
+
15
+ https://en.wikipedia.org/wiki/February_4[Link One, preview=false]
16
+
17
+ https://en.wikipedia.org/wiki/February_4[Link Two, preview=0]
18
+
19
+ https://en.wikipedia.org/wiki/February_4[Link Three, preview=False]
20
+
21
+ == Image block with a Link
22
+
23
+ image::70s.jpg[link="https://montrehack.ca/"]
24
+
25
+ == Image block with a Link Disabled Locally
26
+
27
+ image::70s.jpg[link="https://montrehack.ca/", link_preview=false]
28
+
29
+ == Inlined Images
30
+
31
+ image:70s.jpg[link="https://montrehack.ca/", width=200px]
32
+ image:70s.jpg[link="https://montrehack.ca/", width=200px, link_preview=false]
@@ -0,0 +1,39 @@
1
+ // .links
2
+ // Demonstration of reveal.js and AsciiDoc links
3
+ // :include: //div[@class="slides"]
4
+ // :header_footer:
5
+ = Links
6
+ :imagesdir: images/
7
+
8
+ == Regular
9
+
10
+ https://en.wikipedia.org/wiki/February_4[Link]
11
+
12
+ https://en.wikipedia.org/wiki/February_4[In new Window, window="_blank"]
13
+
14
+ https://en.wikipedia.org/wiki/February_4[In new Window (alternate syntax)^]
15
+
16
+
17
+ == With iFrame Preview Overlay
18
+
19
+ https://en.wikipedia.org/wiki/February_4[Link One, preview=true]
20
+
21
+ https://en.wikipedia.org/wiki/February_4[Link Two, preview=1]
22
+
23
+ https://en.wikipedia.org/wiki/February_4[Link Three, preview=True]
24
+
25
+
26
+ == Image Block with a Link
27
+
28
+ image::70s.jpg[link="https://montrehack.ca/", window="_blank"]
29
+
30
+
31
+ == Image Block with a Link With iFrame Preview
32
+
33
+ image::70s.jpg[link="https://montrehack.ca/", link_preview=true]
34
+
35
+
36
+ == Inlined Images
37
+
38
+ image:70s.jpg[link="https://montrehack.ca/", width=200px]
39
+ image:70s.jpg[link="https://montrehack.ca/", width=200px, link_preview=true]
@@ -0,0 +1,21 @@
1
+ // .mathjax-cdn
2
+ // Demonstration of the Mathjax :mathjaxdir: attribute in action
3
+ // :include: //head/link | //div[@class="slides"]
4
+ // :header_footer:
5
+ = MathJax
6
+ :stem:
7
+ :revealjsdir: https://cdn.jsdelivr.net/npm/reveal.js@3.9.2
8
+ :mathjaxdir: https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/
9
+
10
+ == Math Equation
11
+
12
+ Using standard latexmath:[\LaTeX] syntax:
13
+
14
+ [stem]
15
+ ++++
16
+ \sqrt{37} = \sqrt{\frac{73^2-1}{12^2}} \approx \frac{73}{12} (1 - \frac{1}{2\cdot73^2})
17
+ ++++
18
+
19
+ Another one:
20
+
21
+ stem:[\sum_{i=0}^n i^2 = \frac{(n^2+n)(2n+1)}{6}]
@@ -0,0 +1,20 @@
1
+ // .mathjax
2
+ // Demonstration of our Mathjax integration
3
+ // :include: //div[@class="slides"]
4
+ // :header_footer:
5
+ = MathJax
6
+ :stem:
7
+ :revealjsdir: https://cdn.jsdelivr.net/npm/reveal.js@3.9.2
8
+
9
+ == Math Equation
10
+
11
+ Using standard latexmath:[\LaTeX] syntax:
12
+
13
+ [stem]
14
+ ++++
15
+ \sqrt{37} = \sqrt{\frac{73^2-1}{12^2}} \approx \frac{73}{12} (1 - \frac{1}{2\cdot73^2})
16
+ ++++
17
+
18
+ Another one:
19
+
20
+ stem:[\sum_{i=0}^n i^2 = \frac{(n^2+n)(2n+1)}{6}]
@@ -0,0 +1,192 @@
1
+ = Asciidoctor reveal.js 4.0
2
+ :source-highlighter: highlight.js
3
+ :highlightjs-languages: x86asm,asciidoc
4
+ :icons: font
5
+ :imagesdir: images/
6
+ // reveal.js config
7
+ :customcss: release-4.0.css
8
+ :revealjs_hash: true
9
+ :revealjs_width: 1080
10
+
11
+ == Supports all of reveal.js 3.9.2 features
12
+
13
+
14
+ [background-video="https://github.com/obilodeau/asciidoctor-assets/raw/master/videos/synthwave.mp4",background-opacity=0.7]
15
+ === Background videos
16
+
17
+ === Automatic Source Code Highlighting!
18
+
19
+ icon:exclamation-circle[] Including step-by-step line highlights
20
+
21
+ [.columns.is-vcentered]
22
+ === Assembly from a Compiler
23
+
24
+ [.column]
25
+ [source,x86asm,highlight="3..6|7..9|10|11,12"]
26
+ ----
27
+ main proc near
28
+ var_10 = dword ptr -10h
29
+ push ebp
30
+ mov ebp, esp
31
+ and esp, 0FFFFFFF0h
32
+ sub esp, 10h
33
+ mov eax, offset aHelloWorld
34
+ mov [esp+10h+var_10], eax
35
+ call _printf
36
+ mov eax, 0
37
+ leave
38
+ retn
39
+ main endp
40
+ ----
41
+
42
+ [.column.is-one-third]
43
+ --
44
+ * Backed by Highlight.js
45
+ * Many languages supported
46
+ * Ability to focus on specific lines
47
+ --
48
+
49
+ === With very simple source!
50
+
51
+ [source,asciidoc]
52
+ ....
53
+ [source,x86asm,highlight="3..6|7..9|10|11,12"]
54
+ ----
55
+ main proc near
56
+ var_10 = dword ptr -10h
57
+ push ebp
58
+ mov ebp, esp
59
+ and esp, 0FFFFFFF0h
60
+ sub esp, 10h
61
+ mov eax, offset aHelloWorld
62
+ mov [esp+10h+var_10], eax
63
+ call _printf
64
+ mov eax, 0
65
+ leave
66
+ retn
67
+ main endp
68
+ ----
69
+ ....
70
+
71
+ === And More!
72
+
73
+ * Background images (and gif!)
74
+ * Speaker notes
75
+ * Embedded videos
76
+ * Embedded and interactive iframes
77
+ * etc.
78
+
79
+
80
+ [.columns.is-vcentered]
81
+ == Plus AsciiDoc Features
82
+
83
+ [.column]
84
+ --
85
+ image::asciidoctor-logo.svg[]
86
+
87
+ Powered by Asciidoctor
88
+ --
89
+
90
+ [.column]
91
+ .Available toolchains
92
+ * Ruby / Bundler
93
+ * JavaScript / NPM
94
+ * Standalone executables
95
+ * icon:exclamation-circle[] JVM / Maven
96
+
97
+ [.columns.is-vcentered]
98
+ === Easy Grid Layout
99
+
100
+ [.column]
101
+ * Easy
102
+
103
+ [.column]
104
+ * Flexible
105
+
106
+ [.column]
107
+ Grid Layout
108
+
109
+ [.column.is-one-third]
110
+ --
111
+ [source,asciidoc]
112
+ .Source
113
+ ....
114
+ [.columns]
115
+ === Easy Grid Layout
116
+
117
+ [.column]
118
+ * Easy
119
+
120
+ [.column]
121
+ * Flexible
122
+
123
+ [.column]
124
+ Grid Layout
125
+
126
+ [.column.is-one-third]
127
+ [source,asciidoc]
128
+ [...]
129
+ ....
130
+ --
131
+
132
+ [.columns.is-vcentered]
133
+ === FontAwesome Integration
134
+
135
+ [.column.is-one-third]
136
+ --
137
+ Expressive icon:palette[] Icons icon:icons[]
138
+ at your Fingertips icon:hand-holding-heart[]
139
+
140
+ [.red]
141
+ icon:heart[size=3x]
142
+ --
143
+
144
+ [.column]
145
+ --
146
+ [source,asciidoc]
147
+ .Source
148
+ ....
149
+ Expressive icon:palette[]
150
+ Icons icon:icons[]
151
+ at your Fingertips
152
+ icon:hand-holding-heart[]
153
+
154
+ [.red]
155
+ icon:heart[size=3x]
156
+ ....
157
+ --
158
+
159
+ [.columns]
160
+ === Includes
161
+
162
+ [.column]
163
+ You can include content from other files.
164
+ Including source code!
165
+
166
+ [.column]
167
+ --
168
+ [source,asciidoc]
169
+ .Example Source
170
+ ....
171
+ [source,python]
172
+ ----
173
+ \include::demo.py[]
174
+ ----
175
+ ....
176
+ --
177
+
178
+ === For Great Technical Presentations!
179
+
180
+
181
+ [.important.white.background,transition="zoom"]
182
+ == Can you do that PowerPoint?
183
+
184
+
185
+ [transition=fade,transition-speed=slow]
186
+ == Learn More!
187
+
188
+ * https://github.com/asciidoctor/asciidoctor-reveal.js/[Asciidoctor reveal.js]
189
+ * https://revealjs.com[reveal.js]
190
+ * https://github.com/asciidoctor/asciidoctor/[Asciidoctor]
191
+ * https://asciidoctor.org/docs/what-is-asciidoc/[What is AsciiDoc?]
192
+ * https://github.com/asciidoctor/asciidoctor-reveal.js/raw/master/examples/release-4.0.adoc[This slide deck's AsciiDoc source]