/CarpentriesSlides

Converts Carpentries workbench workshops to slides

Primary LanguageROtherNOASSERTION

Carpentries Slides

This package generates minimal slideshows from a Carpentries Workbench lesson, in order to facilitate teaching workshops.

What is included?

  • A title slide for each episode
  • A slide for each figure in the lesson
  • A slide for each challenge block
  • A slide for each discussion point

Installation

From R:

options(repos = c(
  carpentries = "https://carpentries.r-universe.dev/", 
  CRAN = "https://cran.rstudio.com/"
))

remotes::install_github("WEHI-ResearchComputing/CarpentriesSlides")

Documentation and Usage

Please visit https://wehi-education.github.io/CarpentriesSlides for comprehensive documentation!

FAQ

But I thought Carpentries didn't allow slides?

The main bulk of Carpentries workshops should still be live coding. However, it is a common and accepted practice that certain parts of a workshop can be presented using slides.

For more discussion on this topic, see:

Why not add this feature to the Carpentries workbench directly?

The Workbench maintenance team didn't have time to address my proposed feature: carpentries/workbench#78 (comment). However, I'm very open to merging this into the Workbench when it becomes possible

Why not just use the Extract All Images button?

It's true that this button helps present figures, but I find that opening an image viewer in a workshop doesn't feel as polished as a slideshow. In addition, there is other content that is useful to be included in the slides, as noted above