[WIP] Module on "R Basics, RStudio, and R Project Management"

R/_metadata.yml

@@ -0,0 +1 @@
+page-navigation: true

R/_sidebar.yml

@@ -0,0 +1,4 @@
+- index.qmd
+- r-basics.qmd
+- rstudio.qmd
+- project-management.qmd

R/index.qmd

@@ -0,0 +1,138 @@
+---
+title: "Getting started with R and RStudio"
+description: "This is a description"
+author:
+  - Lewis A. Jones
+  - Erin M. Dillon
+date: "`r Sys.Date()`"
+categories: [r, tidyverse, dataviz]
+difficulty: Beginner
+image: img/2d_density.png
+format:
+  html:
+    toc: true
+  revealjs:
+    smaller: true
+    output-file: index-slides.html
+    css: style/template.css
+    slide-number: c/t
+    include-in-header: style/header.html
+    include-after-body: style/footer.html
+execute:
+  output-location: fragment
+  echo: true
+  warning: false
+  message: false
+  freeze: auto
+filters:
+  - at: pre-ast
+    path: web_and_slides_autogenerated.lua
+editor:
+  markdown:
+    wrap: 72
+---
+
+<!-- ENSURE THAT THIS DOCUMENT FOLLOWS THE MODULE STRUCTURE DESCRIBED IN THE GUIDELINES -->
+<!-- https://docs.google.com/document/d/16cxSA2bA1MnrnpzmN2yzJNCwJVO7Hm5ceyz10sCmnzY/edit?tab=t.0 -->
+
+## Introduction
+
+::: {.narration}
+Prose goes in a `.narration` block: it reads as a paragraph on the website, and
+becomes the speaker notes you talk from on the slides. Press `s` in the deck to
+see the notes view.
+
+Consecutive paragraphs can share one block; they stay separate paragraphs on
+the page and separate notes on the slide.
+:::
+
+::: {.slides-only}
+- a bullet summary for the slide
+- which would be redundant on the page
+:::
+
+::: {.html-only}
+Content that only makes sense in writing (e.g., a long aside, a table of options, a
+link dump) goes in an `.html-only` block and never reaches the deck.
+:::
+
+## One plot per slide
+
+::: {.narration}
+Each `##` heading starts a slide, and the filter closes the slide after every
+figure, so two plots never share one slide. Prose after a figure introduces the next
+figure rather than trailing behind the old one.
+:::
+
+```{r}
+plot(mtcars$wt, mtcars$mpg)
+```
+
+::: {.narration}
+This narration belongs to the plot below, and lands on its slide as speaker notes.
+:::
+
+```{r}
+plot(mtcars$hp, mtcars$mpg)
+```
+
+## Deeper headings
+
+::: {.narration}
+`###` and deeper headings are promoted to slide level, so each becomes its own
+slide instead of piling onto the previous slide. On the website they stay a normal
+sub-heading.
+:::
+
+### A sub-heading
+
+::: {.narration}
+This is its own slide.
+:::
+
+## Building up a slide
+
+::: {.narration}
+When a slide holds two or more code chunks, the filter expands it into an
+auto-animate build-up: one step per chunk, earlier chunks staying on screen, and
+the narration advancing with each step/click.
+:::
+
+```{r}
+x <- mtcars$wt
+mean(x)
+```
+
+::: {.narration}
+The second chunk arrives on the next step, with the first still visible.
+:::
+
+```{r}
+round(sd(x), 3)
+```
+
+## Callouts
+
+::: {.narration}
+A callout gets a slide of its own. The content is un-boxed and the slide is titled by its own heading.
+:::
+
+::: {.callout-note}
+## A note
+
+This box is dropped on the slide, which lets a figure inside it stretch to fit.
+:::
+
+::: {.callout-caution collapse="true"}
+## An exercise solution
+
+A *collapsed* callout is the exception: it keeps its box. Since clicking on
+slides can be awkward, the collapsed content is held back as a fragment and
+revealed when you advance. On the website it stays a click-to-open box.
+:::
+
+## More info
+
+- [Quarto revealjs](https://quarto.org/docs/presentations/revealjs/)
+- [Callouts](https://quarto.org/docs/authoring/callouts.html)
+- the repo README, for the other two ways to build a module

R/project-management.qmd

@@ -0,0 +1,138 @@
+---
+title: "Project Management with RStudio"
+description: "This is a description"
+author:
+  - An author
+  - Another author
+date: "`r Sys.Date()`"
+categories: [r]
+difficulty: Beginner
+image: img/2d_density.png
+format:
+  html:
+    toc: true
+  revealjs:
+    smaller: true
+    output-file: project-management-slides.html
+    css: style/template.css
+    slide-number: c/t
+    include-in-header: style/header.html
+    include-after-body: style/footer.html
+execute:
+  output-location: fragment
+  echo: true
+  warning: false
+  message: false
+  freeze: auto
+filters:
+  - at: pre-ast
+    path: web_and_slides_autogenerated.lua
+editor:
+  markdown:
+    wrap: 72
+---
+
+<!-- ENSURE THAT THIS DOCUMENT FOLLOWS THE MODULE STRUCTURE DESCRIBED IN THE GUIDELINES -->
+<!-- https://docs.google.com/document/d/16cxSA2bA1MnrnpzmN2yzJNCwJVO7Hm5ceyz10sCmnzY/edit?tab=t.0 -->
+
+## Introduction
+
+::: {.narration}
+Prose goes in a `.narration` block: it reads as a paragraph on the website, and
+becomes the speaker notes you talk from on the slides. Press `s` in the deck to
+see the notes view.
+
+Consecutive paragraphs can share one block; they stay separate paragraphs on
+the page and separate notes on the slide.
+:::
+
+::: {.slides-only}
+- a bullet summary for the slide
+- which would be redundant on the page
+:::
+
+::: {.html-only}
+Content that only makes sense in writing (e.g., a long aside, a table of options, a
+link dump) goes in an `.html-only` block and never reaches the deck.
+:::
+
+## One plot per slide
+
+::: {.narration}
+Each `##` heading starts a slide, and the filter closes the slide after every
+figure, so two plots never share one slide. Prose after a figure introduces the next
+figure rather than trailing behind the old one.
+:::
+
+```{r}
+plot(mtcars$wt, mtcars$mpg)
+```
+
+::: {.narration}
+This narration belongs to the plot below, and lands on its slide as speaker notes.
+:::
+
+```{r}
+plot(mtcars$hp, mtcars$mpg)
+```
+
+## Deeper headings
+
+::: {.narration}
+`###` and deeper headings are promoted to slide level, so each becomes its own
+slide instead of piling onto the previous slide. On the website they stay a normal
+sub-heading.
+:::
+
+### A sub-heading
+
+::: {.narration}
+This is its own slide.
+:::
+
+## Building up a slide
+
+::: {.narration}
+When a slide holds two or more code chunks, the filter expands it into an
+auto-animate build-up: one step per chunk, earlier chunks staying on screen, and
+the narration advancing with each step/click.
+:::
+
+```{r}
+x <- mtcars$wt
+mean(x)
+```
+
+::: {.narration}
+The second chunk arrives on the next step, with the first still visible.
+:::
+
+```{r}
+round(sd(x), 3)
+```
+
+## Callouts
+
+::: {.narration}
+A callout gets a slide of its own. The content is un-boxed and the slide is titled by its own heading.
+:::
+
+::: {.callout-note}
+## A note
+
+This box is dropped on the slide, which lets a figure inside it stretch to fit.
+:::
+
+::: {.callout-caution collapse="true"}
+## An exercise solution
+
+A *collapsed* callout is the exception: it keeps its box. Since clicking on
+slides can be awkward, the collapsed content is held back as a fragment and
+revealed when you advance. On the website it stays a click-to-open box.
+:::
+
+## More info
+
+- [Quarto revealjs](https://quarto.org/docs/presentations/revealjs/)
+- [Callouts](https://quarto.org/docs/authoring/callouts.html)
+- the repo README, for the other two ways to build a module