Add slides

Author: ivelasq

.gitignore

@@ -0,0 +1,4 @@
+.Rproj.user
+.Rhistory
+.RData
+.Ruserdata

README.md

@@ -1,2 +1,41 @@
-# getting-started-with-report-writing-using-quarto
-2024-01-23 R-Ladies Nairobi
+# Getting started with report writing using Quarto
+
+## 2024-01-23 R-Ladies Nairobi Presentation
+
+![](images/title.png)
+
+## Data
+
+- [TidyTuesday](https://github.com/rfordatascience/tidytuesday)
+- [@thedivtagguy's geocoding analysis](https://github.com/thedivtagguy/tidytuesday/tree/master/2024/week-03-polling-places/analysis)
+
+## Resources
+
+### Native pipe
+
+- [Understanding the native R pipe |>](https://ivelasq.rbind.io/blog/understanding-the-r-pipe/)
+
+### For R Markdown Users
+
+* [FAQ for R Markdown Users](https://quarto.org/docs/faq/rmarkdown.html)
+* [From R Markdown to Quarto workshop](https://rstudio-conf-2022.github.io/rmd-to-quarto/) taught by Dr. Mine Çetinkaya-Rundel and Dr. Andrew Bray.
+
+### Quartos and reports
+
+- [Making Pretty PDFs with Quarto by Nicola Rennie by](https://nrennie.rbind.io/blog/making-pretty-pdf-quarto/)
+- [Tips for Custom Parameterized PDFs in Quarto by Meghan Hall](https://meghan.rbind.io/blog/quarto-pdfs/)
+- [Introduction to Reproducible Publications with Quarto by Torin White at R-Ladies Rome](https://www.youtube.com/watch?v=hgpL-sppw7E&t=4392s)
+
+### Image
+
+- [RawPixel](https://www.rawpixel.com/)
+
+### Parameterization
+
+- [Parameterized Reporting with Quarto by Jadey Ryan at R-Ladies Abuja](https://jadeyryan.quarto.pub/rladies-abuja-quarto-params/)
+
+### knit_child()
+
+- [Generating dynamic contents in R Markdown and Quarto by Qiushi Yan](https://www.qiushiyan.dev/posts/dynamic-rmd-quarto/)
+- [knit_child in a loop - variable as title (StackOverflow)](https://stackoverflow.com/questions/43873345/knit-child-in-a-loop-variable-as-title)
+- [How do I knit child doc uments with parameters into a main RMarkdown document? (StackOverflow)](https://stackoverflow.com/questions/70655915/how-do-i-knit-child-documents-with-parameters-into-a-main-rmarkdown-document)

_extensions/andrie/reveal-auto-agenda/_extension.yml

@@ -0,0 +1,6 @@
+title: Reveal agenda
+author: Andrie de Vries
+version: 0.0.3
+contributes:
+  filters:
+    - reveal-auto-agenda.lua

_extensions/andrie/reveal-auto-agenda/reveal-auto-agenda.css

@@ -0,0 +1,32 @@
+/* Done display slide header on auto-agenda slides */
+.agenda-slide h1 {
+  size: 0em;
+  display: none;
+}
+
+/* The agenda heading, if specified */
+.agenda-heading {
+  font-size: 1.25em;
+  font-weight: bold;
+  margin-bottom: 0.5em;
+}
+
+/* The container class for auto-agenda */
+.agenda {
+}
+
+.agenda-active {
+  font-weight: bold;
+}
+
+.agenda-inactive {
+  opacity: 0.7;
+}
+
+.agenda-pre-active {
+  /* color: #b22222; */
+}
+
+.agenda-post-active {
+  /* color: #2222b2; */
+}

_extensions/andrie/reveal-auto-agenda/reveal-auto-agenda.lua

@@ -0,0 +1,125 @@
+
+local stringify = pandoc.utils.stringify
+local headers = pandoc.List()
+
+local options_bullets = "bullet"
+local options_heading = nil
+
+-- permitted options include:
+-- auto-agenda:
+--   bullets: none | bullet | numbered
+--   heading: none | heading
+local function read_meta(meta)
+  local options = meta["auto-agenda"]
+  if options ~= nil then
+    if options.bullets ~= nil then
+      options_bullets = stringify(options.bullets)
+    else
+      options_bullets = "bullet"
+    end
+    if options.heading ~= nil then
+      options_heading = options.heading
+    end
+  end
+end
+
+local function get_header_text(el)
+  return el.content
+end
+
+local function scan_headers(el)
+  if el.level == 1  then
+    headers:insert(get_header_text(el))
+  end
+end
+
+--@param el pandoc.Header
+--@return pandoc.Header
+local function change_header_class(el)
+  el.attr.classes = {"agenda-slide"}
+  return el
+end
+
+local function identity(el)
+  return el
+end
+
+local function scan_blocks(blocks)
+  local newBlocks = pandoc.List()
+  local header_n = 0
+
+  -- define agende bullet options
+  local bullet_class = pandoc.BulletList
+  if options_bullets ~= nil then
+    if options_bullets == "none" then
+    bullet_class = identity
+    elseif options_bullets == "numbered" then
+      bullet_class = pandoc.OrderedList
+    end
+  end
+
+  for _, block in pairs(blocks) do
+    if (block ~= nil and 
+      block.t == "Header" and 
+      block.level == 1 and 
+      not block.attr.classes:includes("no-auto-agenda")
+    ) then
+      header_n = header_n + 1
+      change_header_class(block)
+      newBlocks:insert(block)
+
+      -- if defined in options, insert a heading
+      if (options_heading ~= nil) then
+        newBlocks:insert(
+          pandoc.Div(
+            pandoc.Para(options_heading),
+            pandoc.Attr("", {"agenda-heading"})
+          )
+        )
+      end
+
+      -- modify the agenda items for active agenda item
+      local mod_headers = pandoc.List()
+      local agenda_class = {}
+      for i=1, #headers do
+        if (i == header_n) then
+          agenda_class = {"agenda-active"}
+        elseif (i < header_n) then
+          agenda_class = {"agenda-inactive", "agenda-pre-active"}
+        elseif (i > header_n) then
+          agenda_class = {"agenda-inactive", "agenda-post-active"}
+        end
+        mod_headers:insert(
+          pandoc.Div(pandoc.Para(headers[i]), pandoc.Attr("", agenda_class))
+        )
+      end
+          
+      -- insert the agenda items
+      newBlocks:insert(
+        pandoc.Div(
+          bullet_class(mod_headers),
+          pandoc.Attr("", {"agenda"})
+        )
+      )
+    else
+      newBlocks:insert(block)
+    end
+  end
+  
+  -- inject the CSS dependency
+  quarto.doc.addHtmlDependency({
+    name = "reveal-auto-agenda",
+    version = "0.0.3",
+    stylesheets = {"reveal-auto-agenda.css"}
+  })
+
+  return newBlocks
+end
+
+if (quarto.doc.isFormat("revealjs")) then
+  return {
+    {Meta = read_meta}, 
+    {Header = scan_headers}, 
+    {Blocks = scan_blocks}
+  }
+end

_extensions/quarto-ext/fontawesome/_extension.yml

@@ -0,0 +1,7 @@
+title: Font Awesome support
+author: Carlos Scheidegger
+version: 1.1.0
+quarto-required: ">=1.2.269"
+contributes:
+  shortcodes:
+    - fontawesome.lua