How-to-Learn-to-Code / rclass

Repository for the UNC-CH How to Learn to Code R Class
https://how-to-learn-to-code.github.io/rclass/
Other
2 stars 3 forks source link

Markdown Lesson #11

Open snystrom opened 6 years ago

snystrom commented 6 years ago

Opening this to comply with contribution guidelines. Gonna introduce markdown. Yep.

daynefiler commented 6 years ago

Use this at your header:

---
title: "HTLTC-R: Reading and writing files"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{HTLTC-R: Reading and writing files}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
---

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE, collapse = TRUE)
library(htltcR)
```

### Using this document

* Code blocks and R code have a grey background (note, code nested in the text is not highlighted in the pdf version of this document but is a different font).
* \# indicates a comment, and anything after a comment will not be evaluated in R
* The comments beginning with \#\# under the code in the grey code boxes are the output from the code directly above; any comments added by us will start with a single \#
* While you can copy and paste code into R, you will learn faster if you type out the commands yourself. 
* Read through the document after class. This is meant to be a reference, and ideally, you should be able to understand every line of code. If there is something you do not understand please email us with questions or ask in the following class (you're probably not the only one with the same question!). 

### Goals
1. ...

And replace the name "Reading and writing files" with whatever you'd like. Call the file markdown.Rmd and put it in the vignettes folder.

The headers all use ### so they're not too big.

Feel free to add ### Exercises at the end.

daynefiler commented 6 years ago

@aeallen We should add something along the lines of these instructions to either CONTRIBUTING or the README.

aeallen commented 6 years ago

I think that should be included in the CONTRIBUTING.

daynefiler commented 6 years ago

@snystrom Were you planning on using this day 1? Is it finished?

snystrom commented 6 years ago

Not finished. But I'm also not planning on using it... Don't think I've got the time to pull it together today, but if you want to give students something in the mean time try: Here and Here. Honestly, these are better resources than anything I'm going to pull together tonight.

The only thing students need to know for class (if you use .Rmd) anyway is

```{r} code here ```

daynefiler commented 6 years ago

Sounds good. I know what you mean -- putting this all together feels like a waste of time when I think about all the resources already available.