Skip to content

Commit ea1762c

Browse files
committed
Use kbd shortcute where possible
1 parent 0718d3c commit ea1762c

File tree

1 file changed

+39
-39
lines changed

1 file changed

+39
-39
lines changed

docs/presentations/revealjs/presenting.qmd

Lines changed: 39 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ This article covers the mechanics of presenting slides with Reveal. Basic naviga
1919
+----------------------------+--------------------------------------------+
2020

2121
::: {.callout-tip appearance="simple"}
22-
You will often want to enter fullscreen mode when presenting. You can do this by pressing the <kbd>F</kbd> key.
22+
You will often want to enter fullscreen mode when presenting. You can do this by pressing the {{< kbd F >}} key.
2323
:::
2424

2525
In addition to basic keyboard navigation, Reveal supports several more advanced capabilities, including:
@@ -43,22 +43,22 @@ Quarto includes a built in version of the [reveal.js-menu](https://github.com/de
4343
:::
4444

4545
::: {.callout-tip appearance="simple"}
46-
You can also open the navigation menu by pressing the <kbd>M</kbd> key.
46+
You can also open the navigation menu by pressing the {{< kbd M >}} key.
4747
:::
4848

4949
The navigation menu also includes a **Tools** pane that provides access to the various other navigation tools including Fullscreen, Speaker View, Overview Mode, and Print to PDF.
5050

5151
Use the following options to customize the appearance and behavior of the menu:
5252

53-
+------------+--------------------------------------------------------------------------------------------------------------------+
54-
| Option | Description |
55-
+============+====================================================================================================================+
56-
| `side` | Side of the presentation where the menu will be shown. `left` or `right` (defaults to `left`). |
57-
+------------+--------------------------------------------------------------------------------------------------------------------+
58-
| `width` | Width of the menu (`normal`, `wide`, `third`, `half`, `full`, or any valid css length value). Defaults to `normal` |
59-
+------------+--------------------------------------------------------------------------------------------------------------------+
60-
| `numbers` | Add slide numbers to menu items. |
61-
+------------+--------------------------------------------------------------------------------------------------------------------+
53+
+-----------+--------------------------------------------------------------------------------------------------------------------+
54+
| Option | Description |
55+
+===========+====================================================================================================================+
56+
| `side` | Side of the presentation where the menu will be shown. `left` or `right` (defaults to `left`). |
57+
+-----------+--------------------------------------------------------------------------------------------------------------------+
58+
| `width` | Width of the menu (`normal`, `wide`, `third`, `half`, `full`, or any valid css length value). Defaults to `normal` |
59+
+-----------+--------------------------------------------------------------------------------------------------------------------+
60+
| `numbers` | Add slide numbers to menu items. |
61+
+-----------+--------------------------------------------------------------------------------------------------------------------+
6262

6363
For example:
6464

@@ -107,18 +107,18 @@ Overview mode provides an alternate view that shows you a thumbnail for each sli
107107
![](images/overview-mode.png){.border fig-alt="Screenshot of slides shown in overview mode, showing a series of thumbnails for the slides in the presentation."}
108108

109109
::: {.callout-tip appearance="simple"}
110-
You can enable Overview Mode by pressing the <kbd>O</kbd> key.
110+
You can enable Overview Mode by pressing the {{< kbd O >}} key.
111111
:::
112112

113113
## Slide Zoom
114114

115-
Hold down the <kbd>Alt</kbd> key (or <kbd>Ctrl</kbd> in Linux) and click on any element to zoom towards it. Try zooming in on one of these images:
115+
Hold down the {{< kbd Alt linux=Ctrl >}} key and click on any element to zoom towards it. Try zooming in on one of these images:
116116

117117
```{=html}
118118
<iframe class="reveal-demo border" src="demo/mini/zoom.html"></iframe>
119119
```
120120

121-
<kbd>Alt</kbd> or <kbd>Ctrl</kbd> click again to zoom back out.
121+
{{< kbd Alt >}} or {{< kbd Ctrl >}} click again to zoom back out.
122122

123123
## Speaker View
124124

@@ -127,7 +127,7 @@ The speaker view shows the current slide along with the upcoming slide, a timer,
127127
![](images/speaker-view.png){.border fig-alt="Screenshot of reveal.js presentation in Speaker View. On the right, the active slide is shown. The left column contains three sections which show (from top to bottom): the upcoming slide, time (both elapsed and clock time), and a section where speaker notes go."}
128128

129129
::: {.callout-tip appearance="simple"}
130-
You can enable Speaker View by pressing the <kbd>S</kbd> key.
130+
You can enable Speaker View by pressing the {{< kbd S >}} key.
131131
:::
132132

133133
You can add speaker notes to a slide using a div with class `.notes`. For example:
@@ -186,7 +186,7 @@ Note: This feature has been confirmed to work in [Google Chrome](https://google.
186186
To Print to PDF, do the following:
187187

188188
1. Toggle into Print View using the {{< kbd E >}} key (or using the [Navigation Menu](#navigation-menu))
189-
2. Open the in-browser print dialog {{< kbd Ctrl+P win=Ctrl+P mac=Command+P >}}.
189+
2. Open the in-browser print dialog {{< kbd Ctrl+P mac=Command+P >}}.
190190
3. Change the **Destination** setting to **Save as PDF**.
191191
4. Change the **Layout** to **Landscape**.
192192
5. Change the **Margins** to **None**.
@@ -237,15 +237,15 @@ When you click on a hyperlink with `preview-links: true`, the link will be navig
237237

238238
Available values for `preview-link` include:
239239

240-
+-------------+-----------------------------------------------------------------------------------------+
241-
| Value | Description |
242-
+=============+=========================================================================================+
243-
| `auto` | Preview links when presenting in full-screen mode (otherwise navigate to them normally) |
244-
+-------------+-----------------------------------------------------------------------------------------+
245-
| `true` | Always preview links |
246-
+-------------+-----------------------------------------------------------------------------------------+
247-
| `false` | Never preview links (the default) |
248-
+-------------+-----------------------------------------------------------------------------------------+
240+
+------------+-----------------------------------------------------------------------------------------+
241+
| Value | Description |
242+
+============+=========================================================================================+
243+
| `auto` | Preview links when presenting in full-screen mode (otherwise navigate to them normally) |
244+
+------------+-----------------------------------------------------------------------------------------+
245+
| `true` | Always preview links |
246+
+------------+-----------------------------------------------------------------------------------------+
247+
| `false` | Never preview links (the default) |
248+
+------------+-----------------------------------------------------------------------------------------+
249249

250250
For example, here we set `preview-links` to `auto`:
251251

@@ -298,7 +298,7 @@ format:
298298
---
299299
```
300300

301-
A play/pause control element will automatically appear for auto-sliding decks. Sliding is automatically paused if the user starts interacting with the deck. It's also possible to pause or resume sliding by pressing <kbd>A</kbd> on the keyboard.
301+
A play/pause control element will automatically appear for auto-sliding decks. Sliding is automatically paused if the user starts interacting with the deck. It's also possible to pause or resume sliding by pressing {{< kbd A >}} on the keyboard.
302302

303303
You can disable the auto-slide controls and prevent sliding from being paused by specifying `auto-slide-stoppable: false`.
304304

@@ -388,21 +388,21 @@ Here are what the notes canvas and chalkboard look like when activated:
388388
![](images/chalkboard.png){.border fig-alt="Screenshot of chalkboard canvas with color selector on the left, and paintbrush tool at the bottom. The background is dark, and the equation 'y = mx + b' has been drawn in white with a chalky texture."}
389389
:::
390390

391-
To toggle the notes canvas on and off use the <kbd>![](images/canvas-icon.png){width="19" height="17"}</kbd> button or the <kbd>C</kbd> key.
391+
To toggle the notes canvas on and off use the <kbd>![](images/canvas-icon.png){width="19" height="17"}</kbd> button or the {{< kbd C >}} key.
392392

393-
To toggle the chalkboard on and off use the <kbd>![](images/chalkboard-icon.png){width="19" height="20"}</kbd> button or the <kbd>B</kbd> key.
393+
To toggle the chalkboard on and off use the <kbd>![](images/chalkboard-icon.png){width="19" height="20"}</kbd> button or the {{< kbd B >}} key.
394394

395395
Here are all of the keyboard shortcuts associated with the notes canvas and chalkboard:
396396

397-
| Action | Key |
398-
|-------------------------|----------------------|
399-
| Toggle notes canvas | <kbd>C</kbd> |
400-
| Toggle chalkboard | <kbd>B</kbd> |
401-
| Reset all drawings | <kbd>BACKSPACE</kbd> |
402-
| Clear drawings on slide | <kbd>DEL</kbd> |
403-
| Cycle colors forward | <kbd>X</kbd> |
404-
| Cycle colors backward | <kbd>Y</kbd> |
405-
| Download drawings | <kbd>D</kbd> |
397+
| Action | Key |
398+
|-------------------------|-----------------------|
399+
| Toggle notes canvas | {{< kbd C >}} |
400+
| Toggle chalkboard | {{< kbd B >}} |
401+
| Reset all drawings | {{< kbd BACKSPACE >}} |
402+
| Clear drawings on slide | {{< kbd DEL >}} |
403+
| Cycle colors forward | {{< kbd X >}} |
404+
| Cycle colors backward | {{< kbd Y >}} |
405+
| Download drawings | {{< kbd D >}} |
406406

407407
The following mouse and touch gestures can be used for interacting with drawings:
408408

@@ -422,7 +422,7 @@ The following mouse and touch gestures can be used for interacting with drawings
422422

423423
### Restoring Drawings
424424

425-
The <kbd>D</kbd> key downloads any active drawings into a JSON file. You can then restore these drawings when showing your presentation using the `src` option. For example:
425+
The {{< kbd D >}} key downloads any active drawings into a JSON file. You can then restore these drawings when showing your presentation using the `src` option. For example:
426426

427427
``` yaml
428428
---
@@ -449,7 +449,7 @@ The following options are available to customize the behavior and appearance of
449449
+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
450450
| `chalk-effect` | A float in the range `[0.0, 1.0]`, the intensity of the chalk effect on the chalk board. Full effect (default) `1.0`, no effect `0.0`. |
451451
+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
452-
| `src` | Optional file name for pre-recorded drawings (download drawings using the <kbd>D</kbd> key). |
452+
| `src` | Optional file name for pre-recorded drawings (download drawings using the {{< kbd D >}} key). |
453453
+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
454454
| `read-only` | Configuration option to prevent changes to existing drawings. `true`: no changes can be made, `false` (default): changes can be made. |
455455
+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+

0 commit comments

Comments
 (0)