chore(sync): 🔨 synced local '_extensions/rostools/r3-theme/' with remote '_extensions/r3-theme/'

Author: lwjohnst86

_extensions/rostools/r3-theme/_extension.yml

@@ -38,7 +38,7 @@ contributes:
 
     book:
       navbar:
-        logo: "favicon.ico"
+        logo: "favicon-white.ico"
         logo-alt: "Graphic of a capital R with a 3 as a superscript."
         search: true
         pinned: true
@@ -53,9 +53,6 @@ contributes:
     crossref:
       chapters: true
 
-    execute:
-      freeze: auto
-
     knitr:
       opts_chunk:
         R.options:

_extensions/rostools/r3-theme/favicon-r-cubed.ico

@@ -0,0 +1,16 @@
+::: {.callout-tip appearance="minimal" icon="false" collapse="true"}
+## Code used in section
+
+This lists *some*, but not all, of the code used in the section. Some
+code is incorporated into Markdown content, so is harder to
+automatically list here in a code chunk. The code below also includes
+the code from the exercises.
+
+<!-- The stringr subset removes code chunks that aren't shown or typed by the learner. -->
+
+```{r code-appendix}
+#| echo: true
+#| eval: false
+#| ref-label: !expr stringr::str_subset(knitr::all_labels(), "^(unnamed-chunk-.*|purl-only-.*|setup|admin-.*|fig-.*)", negate = TRUE)
+```
+:::

_extensions/rostools/r3-theme/favicon-white.ico

@@ -1,7 +1,7 @@
-The first thing to do is to install these programs. You may already have
-some of them installed and if you do, please make sure that they are at
-least the minimum versions listed below. If not, you will need to update
-them.
+In order to participate in the workshop, you'll need to install these
+programs. You may already have some of them installed and if you did,
+please make sure that they are at least the minimum versions listed
+below. If not, you will need to update them.
 
 ::: panel-tabset
 ### Windows
@@ -15,10 +15,10 @@ them.
     you have installed it before, check the current version by going to
     the menu `Help -> About RStudio`.
 3.  [Git](https://git-scm.com/download/win): Select the "Click here to
-    download" link. Git is used throughout many sessions in the courses.
-    When installing, it will ask for a selecting a "Text Editor" and
-    while we won't be using this in the course, Git needs to know this
-    information so choose Notepad.
+    download" link. Git is used throughout many sessions in the
+    workshop. When installing, it will ask for a selecting a "Text
+    Editor" and while we won't be using this in the workshop, Git needs
+    to know this information so choose Notepad.
 4.  [Rtools](https://cran.r-project.org/bin/windows/Rtools/): Version
     that says "R-release". Rtools is needed in order to build some R
     packages. For some computers, installing Rtools can take some time.
@@ -45,7 +45,7 @@ them.
     ```
 
 3.  [Git](https://git-scm.com/download/mac): Git is used throughout many
-    sessions in the courses. With Homebrew:
+    sessions in the workshop. With Homebrew:
 
     ``` bash
     brew install git
@@ -68,17 +68,17 @@ them.
     the menu `Help -> About RStudio`.
 
 3.  [Git](https://git-scm.com/download/mac): Git is used throughout many
-    sessions in the courses.
+    sessions in the workshop.
 
     ``` bash
     sudo apt install git
     ```
 :::
 
-All these programs are required for the course, even Git. Git, which is
-a software program to formally manage versions of files, is used because
-of it's popularity and the amount of documentation available for it.
-Check out the online book [Happy Git with
+All these programs are required for the workshop, even Git. Git, which
+is a software program to formally manage versions of files, is used
+because of it's popularity and the amount of documentation available for
+it. Check out the online book [Happy Git with
 R](https://happygitwithr.com/), especially the "Why Git" section, for an
 understanding on why we are teaching Git. Windows users tend to have
 more trouble with installing Git than macOS or Linux users. See the
@@ -89,8 +89,8 @@ for help.
 ::: {.callout-note appearance="default"}
 Some pictures may show a Git pane in RStudio, but you may not see it. If
 you haven't created or opened an RStudio R Project (which is taught in
-the introductory course), the Git pane *does not* show up. It only shows
-up in R Projects that use Git to track file changes.
+the introductory workshop), the Git pane *does not* show up. It only
+shows up in R Projects that use Git to track file changes.
 :::
 
 ::: {.callout-note appearance="default"}
@@ -99,26 +99,26 @@ administrative privileges*: You may encounter problems installing
 software due to administrative reasons (e.g. you don't have permission
 to install things). Even if you have issues installing or updating the
 latest version of R or RStudio, you will likely be able to continue with
-the course as long as you have the minimum version listed above for R
+the workshop as long as you have the minimum version listed above for R
 and for RStudio. If you have versions of R and RStudio that are older
 than that, you may need to ask your IT department to update your
 software if you can't do this yourself. Unfortunately, Git is not a
 commonly used software for some organizations, so you may not have it
 installed and you *will* need to ask IT to install it. We *require* it
-for the course, so please make sure to give IT enough time to be able to
-install it for you prior to the course.
+for the workshop, so please make sure to give IT enough time to be able
+to install it for you prior to the workshop.
 :::
 
 Once R, RStudio, and Git have been installed, open RStudio. *If you
-encounter any troubles during these pre-course tasks*, try as best as
+encounter any troubles during these pre-workshop tasks*, try as best as
 you can to complete the task and then let us know about the issues in
-the pre-course survey of the course. If you continue having problems,
-indicate on the survey that you need help and we can try to book a quick
-video call to fix the problem. Otherwise, you can come to the course
-15-20 minutes earlier to get help.
+the pre-workshop survey. If you continue having problems, indicate on
+the survey that you need help and we can try to book a quick video call
+to fix the problem. Otherwise, you can come to the workshop 15-20
+minutes earlier to get help.
 
 If you're unable to complete the setup procedure due to unfixable
 technical issues, you can use Posit Cloud (to use RStudio on the cloud)
-as a final solution in order to participate in the course. For help
-setting up Posit Cloud for this course, refer to the [Posit Cloud setup
-guide](https://guides.rostools.org/posit-cloud).
+as a final solution in order to participate in the workshop. For help
+setting up Posit Cloud for this workshop, refer to the [Posit Cloud
+setup guide](https://guides.rostools.org/posit-cloud).

_extensions/rostools/r3-theme/favicon.ico

@@ -10,8 +10,8 @@ So far, can only be:
 -->
 ```
 
-We will be using specific R packages for the workshop, so you will need to
-install them. A detailed walkthrough for installing the necessary
+We will be using specific R packages for the workshop, so you will need
+to install them. A detailed walkthrough for installing the necessary
 packages is available on the [pre-workshop tasks for installing
 packages](https://r-cubed-intro.rostools.org/preamble/pre-course.html#installing-r-packages)
 section of the introduction workshop, however, you only need to install
@@ -33,30 +33,31 @@ running these commands in the R Console:
 3.  Install the necessary packages for the workshop:
 
     ``` r
-    r3::install_packages_{{< meta workshop_level >}}
+    r3::install_packages_{{< meta workshop_level >}}()
     ```
 
 ::: {.callout-warning appearance="default"}
 You might encounter an error when running this code. That's ok, you can
 fix it if you restart R by going to `Sessions -> Restart R` and re-run
-the code in items 2 and 3, it should work. If that also doesn't work, try to
-complete the other tasks, complete the survey, and let us know you have a
-problem in the survey.
+the code in items 2 and 3, it should work. If that also doesn't work,
+try to complete the other tasks, complete the survey, and let us know
+you have a problem in the survey.
 :::
 
 *Note*: When you see a command like `something::something()`, for
-example with `r3::install_packages_{{< meta workshop_level >}}`, you would
-"read" this as:
+example with `r3::install_packages_{{< meta workshop_level >}}()`, you
+would "read" this as:
 
-> R, can you please use the `install_packages_{{< meta workshop_level >}}`
-> function from the r3 package.
+> R, can you please use the
+> `install_packages_{{< meta workshop_level >}}()` function from the r3
+> package.
 
 The normal way of doing this would be to load the package with
 `library(r3)` and then running the command
-(`install_packages_{{< meta workshop_level >}}`). But by using the `::`,
-we tell R to directly use a function from a package, without needing to
-load the package and all of its other functions too. We use this trick
-because we only want to use the
-`install_packages_{{< meta workshop_level >}}` command from the r3 package
-and not have to load all the other functions as well. In this workshop we
-will be using `::` often.
+(`install_packages_{{< meta workshop_level >}}()`). But by using the
+`::`, we tell R to directly use a function from a package, without
+needing to load the package and all of its other functions too. We use
+this trick because we only want to use the
+`install_packages_{{< meta workshop_level >}}()` command from the r3
+package and not have to load all the other functions as well. In this
+workshop we will be using `::` often.

_extensions/rostools/r3-theme/includes/code-appendix-r.qmd

@@ -1,19 +1,18 @@
-We will explain this a bit during the workshop, but read this to start
-learning how the website is structured and how to read certain things.
-Specifically, there are a few "syntax" type formatting of the text in
-this website to be aware of:
+We will explain this a bit more during the workshop, but read this
+section to know how to read certain things on the website. Specifically,
+there are a few "syntax" type formatting of text on the website to know
+about:
 
 -   Folder names always end with a `/`, for example `data/` means the
     data folder.
--   File names always end with their file extension, for example `content.md`
-    means the file is a Markdown file.
+-   File names always end with their file extension, for example
+    `content.md` means the file is a Markdown file.
 -   R variables are always shown as is. For instance, for the code
     `x <- 10`, `x` is a variable because it was assigned with 10.
 -   Functions always end with `()`, for instance `mean()` or
     `read_csv()`.
--   Sometimes functions have their package name appended with `::` to
-    indicate to run the code from the specific package, since we likely
+-   Sometimes functions have their package name appended with `::` so
+    that you run the code from the specific package, since we likely
     haven't loaded the package with `library()`. For instance, to
     install packages from GitHub using the `{pak}` package we use
-    `pak::pkg_install("user/packagename")`. You'll learn about this more
-    later.
+    `pak::pak("user/packagename")`. You'll learn about this more later.