-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathindex.qmd
199 lines (164 loc) · 9.96 KB
/
index.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
---
title: xaringanExtra v0.6.0 — Now on CRAN!
author: Garrick Aden-Buie
date: '2022-06-07'
slug: xaringanextra-v0.6.0
categories:
- R
- My Projects
- xaringan
- xaringanExtra
- Slides
- Announcement
description: |
xaringanExtra v0.6.0 is now available on CRAN! Plus some new features.
image: feature.png
source_link: 'https://github.com/gadenbuie/garrickadenbuie-com/blob/main/content/blog/2022/xaringanExtra-v0-6-0/index.Rmd'
keywords: rstats
editor_options:
chunk_output_type: console
---
<!-- Links -->
[xaringanExtra]: https://pkg.garrickadenbuie.com/xaringanExtra
[xaringan]: https://slides.yihui.org/xaringan
[xe-gh]: https://github.com/gadenbuie/xaringanExtra
[xe-ru]: https://gadenbuie.r-universe.dev/
```{r setup, include=FALSE}
knitr::opts_chunk$set(
echo = FALSE, warning = FALSE, message = FALSE,
fig.width = 9, fig.height = 10
)
options(htmltools.dir.version = TRUE)
```
::: lead
I'm [delighted]{.superlative} to announce that [xaringanExtra] is now available on CRAN!
Bring something extra to your [xaringan] slides.
This is the first release available via `install.packages()`
and it includes [a new extra](#banner), plus some bug fixes.
Read on to learn more!
:::
```{css echo=FALSE}
.superlative {
border-bottom: 1px dashed;
cursor: pointer;
}
.superlative:hover {
color: var(--bs-warning);
}
.slide-preview {
max-width: 480px;
}
```
```{js, echo = FALSE}
document.querySelector('.superlative').addEventListener('click', function(ev) {
const superlatives = [
'delighted', 'charmed', 'elated', 'excited', 'pleased', 'thrilled', 'chuffed',
'tickled pink', 'overjoyed', 'ecstatic', 'stoked', 'proud', 'fired up'
]
const el = ev.target
const idx = Math.floor(Math.random() * superlatives.length)
el.innerText = superlatives[idx]
})
```
## What is xaringanExtra?
What can xaringanExtra do for you and your xaringan slides?
A whole lot!
Here are all the things you can do with xaringanExtra:
- Add an overview of your presentation with [tile view](https://pkg.garrickadenbuie.com/xaringanExtra/#/tile-view)
- Make your slides [editable](https://pkg.garrickadenbuie.com/xaringanExtra/#/editable)
- Share your slides in style with [share again](https://pkg.garrickadenbuie.com/xaringanExtra/#/share-again)
- Broadcast your slides in real time to viewers with [broadcast](https://pkg.garrickadenbuie.com/xaringanExtra/#/broadcast)
- Scribble on your slides during your presentation with [scribble](https://pkg.garrickadenbuie.com/xaringanExtra/#/scribble)
- Announce slide changes with a [subtle tone](https://pkg.garrickadenbuie.com/xaringanExtra/#/slide-tone)
- Animate slide transitions with [animate.css](https://pkg.garrickadenbuie.com/xaringanExtra/#/animate-css)
- Add tabbed panels to slides with [panelset](https://pkg.garrickadenbuie.com/xaringanExtra/#/panelset)
- Add a logo to all of your slides with [logo](https://pkg.garrickadenbuie.com/xaringanExtra/#/logo)
- Add a top or bottom banner to all of your slides with [banner](https://pkg.garrickadenbuie.com/xaringanExtra/#/banner)
- Add a search box to search through your slides with [search](https://pkg.garrickadenbuie.com/xaringanExtra/#/search)
- Use the [Tachyons CSS utility toolkit](https://pkg.garrickadenbuie.com/xaringanExtra/#/tachyons)
- Add a live video feed of your [webcam](https://pkg.garrickadenbuie.com/xaringanExtra/#/webcam)
- Add one-click code copying with [clipboard](https://pkg.garrickadenbuie.com/xaringanExtra/#/clipboard)
- Always play gifs from the start with [freezeframe](https://pkg.garrickadenbuie.com/xaringanExtra/#/freezeframe)
- Fit your slides to [fill the browser window](https://pkg.garrickadenbuie.com/xaringanExtra/#/fit-to-screen)
- Add [extra CSS styles](https://pkg.garrickadenbuie.com/xaringanExtra/#/extra-styles)
But wait, there's more!
These features aren't limited to just [xaringan] slides.
A bunch of the features can be used in regular R Markdown documents, in particular:
[panelset](https://pkg.garrickadenbuie.com/xaringanExtra/#/panelset),
[animate.css](https://pkg.garrickadenbuie.com/xaringanExtra/#/animate-css),
[Tachyons](https://pkg.garrickadenbuie.com/xaringanExtra/#/tachyons),
and [clipboard](https://pkg.garrickadenbuie.com/xaringanExtra/#/clipboard).
## Installing xaringanExtra
Installing xaringanExtra is now a whole lot easier:
```r
install.packages("xaringanExtra")
```
As always, you can still get the latest and greatest in-development versions
from [GitHub][xe-gh]
``` r
# install.packages("remotes")
remotes::install_github("gadenbuie/xaringanExtra")
```
or from [gadenbuie.r-universe.dev][xe-ru].
``` r
options(repos = c(
gadenbuie = 'https://gadenbuie.r-universe.dev',
CRAN = 'https://cloud.r-project.org'
))
install.packages('xaringanExtra')
```
## Wait, it's on CRAN now?
Yeah, can you believe it?!
When I [started working](https://github.com/gadenbuie/xaringanExtra/commit/636fbfd84221d70f899242fdd7bd651a497311cd)
on xaringanExtra (checks notes)
`r difftime(as.Date("2022-06-07"), as.Date("2019-11-07"), units = "days")`
days ago — that's 2 ½ years or 13 pandemic years ago —
I never expected that xaringanExtra would ever be anything beyond
a toy package I used for fun ~~procrastination~~ experiments
while preparing slides for talks and workshops.
I'm honored and grateful that so many other people have found the package helpful
and have used it to make their presentations more engaging!
I'm also humbled that when the Quarto team developed
the [next generation of slide-building tools](https://quarto.org/docs/presentations/revealjs/),
they made a point to ensure that
Quarto presentations include, out-of-the-box,
many of the features from xaringanExtra.
I'd also like to thank the community of users and developers
who have reported issues or
shared xaringanExtra on social media or talked about it in workshops and talks.
A big up-front thank you to [Matt Warkentin](https://mattwarkentin.github.io/)
for developing one of my favorite extras: [🧑‍🎨 Scribble](https://pkg.garrickadenbuie.com/xaringanExtra/#/scribble?id=%f0%9f%91%a9%f0%9f%8e%a8-scribble)!
Sincerely, thank you to the 54 awesome people who contributed issues, advice, fixes or features
since I started working on xaringanExtra:
[@albert-ying](https://github.com/albert-ying), [@apreshill](https://github.com/apreshill), [@BerriJ](https://github.com/BerriJ), [@brianmsm](https://github.com/brianmsm), [@chainsawriot](https://github.com/chainsawriot), [@ColinConwell](https://github.com/ColinConwell), [@dataning](https://github.com/dataning), [@dmi3kno](https://github.com/dmi3kno), [@drfurtado](https://github.com/drfurtado), [@dunstone-a](https://github.com/dunstone-a), [@evanmorier](https://github.com/evanmorier), [@giabaio](https://github.com/giabaio), [@GitHunter0](https://github.com/GitHunter0), [@gpapageorgiou](https://github.com/gpapageorgiou), [@gtalckmin](https://github.com/gtalckmin), [@howardm](https://github.com/howardm), [@ignacio82](https://github.com/ignacio82), [@issactoast](https://github.com/issactoast), [@jhelvy](https://github.com/jhelvy), [@jmgirard](https://github.com/jmgirard), [@jooyoungseo](https://github.com/jooyoungseo), [@juandodyk](https://github.com/juandodyk), [@jvcasillas](https://github.com/jvcasillas), [@kim-soo-hwan](https://github.com/kim-soo-hwan), [@koliajaykr](https://github.com/koliajaykr), [@konstruktur](https://github.com/konstruktur), [@LauraRK](https://github.com/LauraRK), [@mattwarkentin](https://github.com/mattwarkentin), [@MayaGans](https://github.com/MayaGans), [@mchiapello](https://github.com/mchiapello), [@mfherman](https://github.com/mfherman), [@mine-cetinkaya-rundel](https://github.com/mine-cetinkaya-rundel), [@nithinmkp](https://github.com/nithinmkp), [@nucleic-acid](https://github.com/nucleic-acid), [@pat-s](https://github.com/pat-s), [@pomang-211](https://github.com/pomang-211), [@psads-git](https://github.com/psads-git), [@py9mrg](https://github.com/py9mrg), [@realauggieheschmeyer](https://github.com/realauggieheschmeyer), [@RRMaximiliano](https://github.com/RRMaximiliano), [@rsimonmd](https://github.com/rsimonmd), [@ryanstraight](https://github.com/ryanstraight), [@SchmidtPaul](https://github.com/SchmidtPaul), [@simonedu](https://github.com/simonedu), [@skamper1](https://github.com/skamper1), [@spcanelon](https://github.com/spcanelon), [@Sumidu](https://github.com/Sumidu), [@tgerke](https://github.com/tgerke), [@TuQmano](https://github.com/TuQmano), [@uriahf](https://github.com/uriahf), [@W-Mohammed](https://github.com/W-Mohammed), [@yonicd](https://github.com/yonicd), [@youngwoos](https://github.com/youngwoos), and [@yyzeng](https://github.com/yyzeng).
## A new extra: banner! {#banner}
One new feature made it into this release: [📰 banner](https://pkg.garrickadenbuie.com/xaringanExtra/#/banner)!
The idea behind banner is simple.
Sometimes you want to have some text appear on _every slide in your presentation_
(or at least most of the slides).
You might want to show a short link to the slides being presented.
Or you might want to add your name or talk title in the slide margin
so that attendees who missed your intro
or don't have the conference schedule in front of them
know who you are and what you're talking about.
`xaringanExtra::use_banner()` solves this problem.
Just add a chunk like the one below to your slides
````markdown
```{r xaringan-banner, echo=FALSE}`r ''`
xaringanExtra::use_banner(
top_left = "My Awesome Talk Title",
top_right = "Mr. Fancy Pants",
bottom_left = "bit.ly/my-awesome-talk",
exclude = "title-slide"
)
```
````
and you'll get slides that look kind of like this!
::: {.center .slide-preview}
```{r echo=FALSE}
xaringanExtra::embed_xaringan(
"https://pkg.garrickadenbuie.com/xaringanExtra/banner",
ratio = "4:3"
)
```
:::