docs - revealjs work

Author: cscheid

docs/presentations/revealjs/index.qmd

@@ -4,7 +4,7 @@ title: "Reveal.js presentations"
 
 ## Overview
 
-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:
+Like other documents, a `revealjs` presentation in Quarto is a Markdown document that is compiled to an HTML presentation using the [`reveal.js` HTML presentation framework](https://github.com/hakimel/reveal.js/). Add `format: revealjs` to the document's front matter to choose the slideshow format:
 
 ```yaml
 ---

examples/presentations/11-auto-stretch/slides.qmd

@@ -16,3 +16,11 @@ To opt out, set `auto-stretch: false` in the front matter (deck-wide), or give
 the image an explicit `width`/`height`, or mark it `.nostretch`:
 
 ![](diagram.svg){.nostretch}
+
+## Standalone (with stretch)
+
+![](diagram.svg)
+
+## Standalone nostretch
+
+![](diagram.svg){.nostretch}

examples/presentations/12-brand/_brand.yml

@@ -0,0 +1,17 @@
+color:
+  palette:
+    dark-grey: "#222222"
+    blue: "#ddeaf1"
+  background: blue
+  foreground: dark-grey
+  primary: black
+
+logo:
+  medium: logo.png
+
+typography:
+  fonts:
+    - family: Jura
+      source: google
+  base: Jura
+  headings: Jura

examples/presentations/12-brand/_quarto.yml

@@ -0,0 +1,2 @@
+project:
+  type: default

examples/presentations/12-brand/diagram.svg

@@ -0,0 +1,19 @@
+---
+title: "Auto-stretch"
+format: revealjs
+# brand: !str _brand.yml # !str forces Quarto to
+---
+
+## A single image fills the slide
+
+When a slide holds just one image, Quarto sizes it to fill the available space
+so it never overflows. This happens by default.
+
+![](diagram.svg)
+
+## Keeping an image at its natural size
+
+To opt out, set `auto-stretch: false` in the front matter (deck-wide), or give
+the image an explicit `width`/`height`, or mark it `.nostretch`:
+
+![](diagram.svg){.nostretch}