website - tweaks to revealjs example

Author: cscheid

docs/authoring/revealjs/basics.qmd

@@ -0,0 +1,13 @@
+---
+title: RevealJS Basics
+---
+
+
+``` {.yaml preview="/examples/scrollable-and-smaller"}
+---
+format:
+  revealjs:
+    smaller: true
+    scrollable: true
+---
+```

docs/presentations/revealjs/index.qmd

@@ -4,8 +4,7 @@ title: "Reveal.js presentations"
 
 ## Overview
 
-You write a reveal.js presentation the same way you write any Quarto
-document — as Markdown — and choose the slide format in the front matter:
+Like other documents, a reveal.js presentation in Quarto is a Markdown document. Add `format: revealjs` to the document's front matter to choose the slideshow format:
 
 ```yaml
 ---
@@ -15,10 +14,7 @@ format: revealjs
 
 From there, headings become slides and the document metadata becomes a
 title slide. The rest of this page walks through the slide-authoring
-features Quarto 2 supports today. Each feature is paired with a small,
-self-contained example you can render and adapt; the example projects live
-under
-[`examples/presentations/`](https://github.com/quarto-dev/q2/tree/main/examples/presentations).
+features Quarto 2 supports today.
 
 ::: {.callout-note}
 Quarto 2's reveal.js support is still growing. This page documents only
@@ -29,10 +25,9 @@ available.
 
 ## Creating slides
 
-Slide boundaries follow heading levels. A level-2 heading (`##`) starts a
-slide; a level-1 heading (`#`) starts a *section*, gathering the slides
-beneath it into a vertical stack; and a horizontal rule (`---`) starts a
-new slide where you have no heading to give it.
+A level-2 heading (`##`) starts a new slide, and the heading content becomes the slide title. A level-1 heading (`#`) starts a *section*, gathering the slides
+beneath it into a vertical stack. A horizontal rule (`---`) starts a
+new slide with no title.
 
 :::: {#demo-creating-slides .embed-example-iframe file="/examples/presentations/01-creating-slides/slides.html"}
 ```markdown
@@ -84,9 +79,7 @@ untitled slide. [View source](https://github.com/quarto-dev/q2/tree/main/example
 
 ### The title slide
 
-When the front matter carries a `title` — and, optionally, an `author` or
-`date` — Quarto opens the deck with a generated title slide. Omit those
-fields and the deck starts directly on your first content slide.
+When the front matter carries a `title` metadata entry (and optionally, an `author` or `date` fields), Quarto will produce a title slide.
 
 ### Slide level
 

examples/presentations/02-sections/slides.qmd

@@ -1,26 +1,18 @@
 ---
-title: "Sections & Breaks"
-author: "Quarto"
 format: revealjs
 ---
 
 # Part One
 
 ## First topic
 
-- Point A
-- Point B
-
-## Second topic
-
-A level-1 heading (`# Part One`) starts a new section. Its level-2 slides
-become vertical children beneath it.
+Content.
 
 # Part Two
 
 ## Another topic
 
-Content for the second section.
+Content.
 
 ---
 

examples/presentations/03-fragments/slides.qmd

@@ -1,32 +1,19 @@
 ---
-title: "Fragments"
 format: revealjs
 ---
 
-## Reveal on click
+# Part One
 
-Wrap content in a `.fragment` div to reveal it one step at a time.
+## First topic
 
-::: {.fragment}
-Appears on the first click.
-:::
+Content.
 
-::: {.fragment .fade-up}
-Then this one fades up.
-:::
+# Part Two
 
-::: {.fragment .highlight-red}
-Then this one turns red.
-:::
+## Another topic
 
-## Controlling the order
+Content.
 
-`fragment-index` sets the order explicitly, regardless of source position.
-
-::: {.fragment fragment-index="2"}
-Shown second.
-:::
+---
 
-::: {.fragment fragment-index="1"}
-Shown first.
-:::
+An untitled slide, created with a horizontal rule.