Academic writing with Quarto

Enabling more productive scholarly communication

Dr. Jerid Francom

Jan 26, 2024

Overview

• Quarto review
• Academic writing features
• Lab 01: Academic writing with Quarto

Quarto review

Quarto documents have two main parts: front matter and content.

Front matter

---
title: "Academic writing with Quarto"
format: pdf
---

Front matter + content

---
title: "Academic writing with Quarto"
format: pdf
---

## Overview

This is my overview of this important topic. ...

Front matter + content + code

---
title: "Academic writing with Quarto"
format: pdf
---

## Overview

This is my overview of this important topic. ...

```{r}
x <- 1:10
x
```

This code shows us the values of `x`.

Academic writing features

Numbered sections

---
title: "Academic writing with Quarto"
format:
  pdf:
    number-sections: true
---

## Overview

## Setup

### Install Quarto

### Create a new Quarto project

Tables of contents

---
title: "Academic writing with Quarto"
format:
  pdf:
    number-sections: true
    toc: true
    toc-depth: 1
---

## Overview

## Setup

### Install Quarto

### Create a new Quarto project

Cross-referencing tables

---
title: "Academic writing with Quarto"
format: pdf
---

## Overview

View @tbl-test below.

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| A        | B        | C        |
| D        | E        | F        |

: A simple markdown table {#tbl-test}

Cross-referencing figures

---
title: "Academic writing with Quarto"
format: pdf
---

## Overview

View @fig-test below.

```{r}
#| label: fig-test
#| fig-cap: "A test plot!"

plot(1:10)
```

In-line citations and references

---
title: "Academic writing with Quarto"
format: pdf
bibliography: bibliography.bib
---

## Overview

There are various ways to do in-line citations. Here are two:

1. @tidyverse2019
2. [@tidyverse2019]

# References

Bibliography file

bibliography.bib contains BibTeX entries for all of the references in the document.

@Article{tidyverse2019},
  title = {Welcome to the {tidyverse}},
  author = {Hadley Wickham and Mara Averick and Jennifer Bryan and Winston Chang and Lucy D'Agostino McGowan and Romain François and Garrett Grolemund and Alex Hayes and Lionel Henry and Jim Hester and Max Kuhn and Thomas Lin Pedersen and Evan Miller and Stephan Milton Bache and Kirill Müller and Jeroen Ooms and David Robinson and Dana Paige Seidel and Vitalie Spinu and Kohske Takahashi and Davis Vaughan and Claus Wilke and Kara Woo and Hiroaki Yutani},
  year = {2019},
  journal = {Journal of Open Source Software},
  volume = {4},
  number = {43},
  pages = {1686},
  doi = {10.21105/joss.01686},
}

Find articles and BibTeX references

Search engines

• Linguistics and Language Behavior Abstracts (LLBA) interface (WFU only)
• Google Scholar

BibTeX entries

Some engines and publishers provide BibTeX entries for articles. Others do not.

If not, find the DOI and use doi2bib to generate one.

Get BibTeX entries

Here are some common situtations.

Lab 01: Academic writing with Quarto

Setup

• Clone the Lab 01 repository from GitHub
• Open the project in RStudio
• Follow the instructions in README.md

Remember you can use the Recipe 01 as a reference, or even other documentation on the Quarto website.

Looking ahead

Current tasks

1. Lab 01: Academic writing with Quarto
2. Project step 1: Interest statement
3. Self-assessment 1

Next week

1. Reading: Data
   • Annotate with Hypothes.is
2. Lessons: Objects, Packages and functions