---
title: "My first Quarto document"
format:
  html:
    toc: true
    toc-depth: 1
    embed-resources: true
editor: 
  markdown: 
    wrap: sentence
---

# Intro

**Macalester College** is in the *Twin Cities*.
It has:

-   four seasons
-   bagpipes
-   delightful students

Check it out for yourself:

![](https://www.macalester.edu/about/wp-content/uploads/sites/191/2019/12/campusmap336.png)

\
\
\


# Exercise 1: Deduce Quarto features

Check out the appearance and contents of this document.
Thoughts?

In the toolbar at the top of this document, click the **Render** button with the blue arrow to render this .qmd file into a .html file.

-   You will see status messages appear in the "Background Jobs" pane near the Console.
-   A webpage will popup in your browser at `http://localhost:####/` or in RStudio's Viewer pane (in the same area as the Files pane) which displays the rendered HTML file.

Toggling between this .qmd and the rendered HTML, explain the purpose of the following features in the .qmd file:

`*`

`**`

`#`

`-`

`\`

`![](url)`

Also check to see in the Files pane of RStudio or in your File Explorer/Finder that you see a file called `quarto-demo.html` in the same folder as `quarto-demo.qmd`.

-   This is the same as what popped up in your web browser or the Viewer pane but is a **saved file on your computer** that can be shared/uploaded.
-   When you render .html files for assignments, you will submit this .html on Moodle.

\
\
\

# Exercise 2: Code

How does the following line of code appear in the .qmd?
The .html?
So...?!

seq(from = 100, to = 1000, by = 50)

\
\
\

# Exercise 3: Chunks

Quarto isn't a mind reader -- we must distinguish R code from text.
We do so by putting code inside an **R code chunk**:

```{r}

```

-   Put the `seq()` code from Exercise 2 in the chunk.
-   Press the green arrow in the top right of the chunk. What happens in the qmd?
-   Render. What appears in the html: R code, output, or both?

\

**Tip 1:** You can use a keyboard shortcut to insert a code chunk!

-   Ctrl + Alt + I (Windows and Linux)
-   Command + Option + I (Mac)

You can also insert a code chunk by clicking the code chunk icon in the top menu bar of this pane: green square with a "C" inside with a green plus sign in the top left.

**Tip 2:** You can run a code chunk without pressing the green play button with a keyboard shortcut!

-   Ctrl + Shift + Enter (Windows and Linux)
-   Command + Shift + Enter (Mac)

\
\
\

# Exercise 4: Practice

-   Use R code to create the following sequence: 10 10 10 10
-   Store the sequence as `four_tens`.
-   Use an R function (which we haven't learned!) to add up the numbers in `four_tens`.

\
\
\

# Exercise 5: Fix this code

Code is a form of communication, and the code below doesn't cut it.

Put the code in a chunk and fix it.

Rep(x = 1, times = 10) seq(from=100,to=1000,length=20) theNumberofStudentsinthisclass\<-27

\
\
\

# Exercise 6: Comments

Run the chunk below.
Notice that R ignores anything in a line starting with a pound sign (`#`).
If we took the `#` away we'd get an error!

```{r}
# This is a comment
4 + 5
```

We'll use this feature to **comment our code**, i.e. leave short notes about what our code is doing.
Below, replace the `???` with an appropriate comment.

```{r}
# ???
temperature_c <- 10
temperature_f <- temperature_c * 9/5 + 32
temperature_f
```

# Wrapping up

When you're done:

-   Close the `http://localhost:####/` tab in your browser if the rendered HTML opened there. (Ignore this if it opened in the Viewer pane.)
-   Open up the Console pane in RStudio, and click the Background Jobs tab.
-   Click the Stop button in the top right of the Background Jobs pane to end the rendering process.

Use these steps whenever you're done working with a .qmd file and are rendering it to an .html file.