index.Rmd

---
title: "Sharing Your Work with xaringan"
author: 
- name: Silvia Canelón, Ph.D.
  url: https://silvia.rbind.io
  affiliation: University of Pennsylvania
  affiliation_url: https://www.dbei.med.upenn.edu
date: November 3rd, 2020
description: |
  An Introduction to xaringan for Presentations: The Basics and Beyond
site: distill::distill_website
---

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = FALSE)

# Learn more about creating websites with Distill at:
# https://rstudio.github.io/distill/website.html

# Learn more about publishing to GitHub Pages at:
# https://rstudio.github.io/distill/publish_website.html#github-pages

```

```{r meta, echo=FALSE}
library(metathis)
meta() %>%
  meta_general(
    description = "An Introduction to xaringan for Presentations: The Basics and Beyond",
    generator = "xaringan and remark.js"
  ) %>% 
  meta_name("github-repo" = "spcanelon/xaringan-basics-and-beyond") %>% 
  meta_social(
    title = "Sharing Your Work with xaringan",
    url = "https://bit.ly/xaringan-nhsr",
    image = "https://repository-images.githubusercontent.com/304962818/38fb4600-20f5-11eb-9597-52659d721631",
    image_alt = paste(
      "Title slide of Sharing Your Work with xaringan:",
      "An Introduction to xaringan for Presentations: The Basics and Beyond",
      "Workshop presented by Silvia Canelon"
      ),
    og_type = "website",
    og_author = "Silvia Canelon",
    twitter_card_type = "summary_large_image",
    twitter_creator = "@spcanelon"
  )
```

```{r cover-image, echo=FALSE, fig.align="center", fig.cap=NULL, fig.alt="Cover image for the two day workshop with the title (same as this page) and the subtitle 'An Introduction to xaringan: the Basics and Beyond'. My name is listed as well as the dates November 3rd and 5th of 2020. The image features some blue, red, and yellow artwork in the background and the hex logo for the xaringan package in the lower right corner."}
knitr::include_graphics("cover-image.png")
```

# Welcome

This is the course site for the _Sharing Your Work with xaringan_ workshop created by Dr. Silvia Canelón for the [NHS-R Community](https://nhsrcommunity.com/about/) [2020 Virtual Conference](https://nhsrcommunity.com/nhsr-conference-2020/).

<aside>
```{r, out.height=43}
knitr::include_graphics("https://nhsrcommunity.com/wp-content/uploads/2018/02/logo.png")
```
</aside>

This four-hour hands-on workshop will be a gentle introduction to the [xaringan](https://github.com/yihui/xaringan#xaringan) package as a tool to create impressive presentation slides that can be deployed to the web for easy sharing.

- **Day 1** will cover the nuts and bolts of creating presentation slides using [xaringan](https://github.com/yihui/xaringan#xaringan) and deploying them in HTML format for easy sharing with others.

<aside>
Tuesday, Nov. 3<br/>3-5pm BST ([check your time zone](https://www.worldtimebuddy.com/?qm=1&lid=2643743,5128581&h=5128581&date=2020-11-3&sln=10-12))
</aside>

```{r embed-xaringan-01, echo=FALSE, eval=FALSE}
xaringanExtra::embed_xaringan(url = "https://spcanelon.github.io/xaringan-basics-and-beyond/slides/day-01-basics.html", ratio = "16:9")
```

- **Day 2** will cover how to take your slides to the next level with the [xaringanExtra](https://pkg.garrickadenbuie.com/xaringanExtra/#/README?id=xaringanextra) package and how to customize slides with CSS.

<aside>
Thursday, Nov. 5<br/>3-5pm BST ([check your time zone](https://www.worldtimebuddy.com/?qm=1&lid=2643743,5128581&h=5128581&date=2020-11-5&sln=10-12))
</aside>

```{r embed-xaringan-02, echo=FALSE, eval=FALSE}
xaringanExtra::embed_xaringan(url = "https://spcanelon.github.io/xaringan-basics-and-beyond/slides/day-02-beyond.html", ratio = "16:9")
```

This workshop is designed for R users already familiar with R Markdown and GitHub.

# Prework: Essential

- The workshop will take place within an RStudio Cloud project, please sign up for a free RStudio Cloud account here: https://rstudio.cloud.
- We will be utilizing Zoom for this workshop, please download and install [the latest version beforehand](https://zoom.us/download).

# Prework: Optional

We will use the software listed below only as an important backup in the event we experience technical difficulties with RStudio Cloud.

- Install [R](https://cloud.r-project.org/) and [RStudio Desktop](https://rstudio.com/products/rstudio/download/) on your computer. 

You can find step-by-step instructions for installing these here: [macOS](https://www.youtube.com/watch?v=GM88tYlEy_g), [Windows](https://www.youtube.com/watch?v=JRKmZK5-6aE).

<aside>
Thanks to<br/>Stephan Kadauke
</aside>

- Install the following packages:

```{r, eval=FALSE, echo=TRUE}
# From CRAN
install.packages("xaringan")

# From GitHub
remotes::install_github("nhs-r-community/NHSRtheme")
remotes::install_github("nhs-r-community/NHSRdatasets")
remotes::install_github("gadenbuie/xaringanExtra")
remotes::install_github("rstudio/fontawesome")
remotes::install_github("mitchelloharawild/icons")
```

# Resources

- Link to this website: [bit.ly/xaringan-nhsr](https://bit.ly/xaringan-nhsr)
- [RStudio Cloud workspace](https://bit.ly/3mfJM4k) and companion [source materials](https://github.com/spcanelon/xaringan-basics-and-beyond/tree/main/materials)
- Day 1: The Basics: [Slides](slides/day-01-basics.html) | [Video](https://youtu.be/M3skTMQbCD0)
- Day 2: The Beyond: [Slides](slides/day-02-beyond.html) | [Video](https://youtu.be/cAtpZxW4bTI)

# Acknowledgments {.appendix}

This workshop draws from various sources, most notably Alison Hill’s [Making Slides with R Markdown](https://arm.rbind.io/slides/xaringan.html) and Greg Wilson's [Teaching Tech Together](http://teachtogether.tech/en/). This workshop ran smoothly with the help of [Laurie Baker](https://lauriebaker.rbind.io/) as co-pilot.

This website was made with the [distill package](https://rstudio.github.io/distill/) and a custom theme designed by Silvia Canelón.