Adding and Removing Assignments

Assignments are hosted on the Assignments page and include a list of Labs and a list of Worksheet Packets. These lists build automatically if the assignment files follow a particular naming scheme. Below we discuss how to add assignments to the list. They can be removed by renaming the files or removing them entirely from the repository.

For further reading on how these lists are made, see the Quarto documentation on document listings.

Worksheets

Worksheets are sets of drill-style problems that provide practice with the concepts and skills of a particular day’s lesson. They are stored within the subdirectory containing all of the materials for that day.

PDF handouts

Create a file called ws.qmd alongside the notes for a given day’s materials. Your directory should look like this:
```
intro-to-probability
├── notes.qmd
├── ws.qmd
```
At least two YAML options should be specified in the front-matter, title and the custom handout format:
```
---
title: Calculating Chances
format: stat20handout-pdf
---
```
Upon rendering the site, this assignment should appear on the assignments page. The format of the assignment list is controlled by the assignments template, which will automatically assign numbers to the worksheets based on their order in the directory.

The pdf notes use the stat20handout custom pdf format. See Custom Formats for more information on its use.

Qmd handouts

Just like with pdfs, create a file called ws.qmd alongside the notes for a given day’s materials. Your directory should look like this:
```
intro-to-probability
├── notes.qmd
├── ws.qmd
```
Add the following to the front-matter of ws.qmd.
```
---
title: Simulation
format:
  html:
    code-tools: 
      source: true
      toggle: false
sidebar: false
---
```
The title should have the name of topic, usually the same as the title of the notes. This name will be used in creating the worksheet name in the listing. The remaining yaml options will provide a link at the top right of the worksheet webpage that, when clicked, will produce a pop-up of the source of the qmd file. Students can copy and paste this into a blank qmd file in RStudio (and can remove the extra yaml options).

If you have multiple worksheet files on a single day, you can differentiate them by adding a single letter or digit following ws and hyphen. ws.qmd, ws-2.qmd, and ws-b.qmd should all work. See the source for the assignment page for the rule that determines which files show up in the listing.

Labs

Warning

Under Construction