https://github.com/nrennie/lu-psychology-quarto

Quarto workshop for Lancaster University Psychology department.
https://github.com/nrennie/lu-psychology-quarto

quarto workshop

Last synced: 18 days ago
JSON representation

Quarto workshop for Lancaster University Psychology department.

• Host: GitHub
• URL: https://github.com/nrennie/lu-psychology-quarto
• Owner: nrennie
• License: cc-by-4.0
• Created: 2024-05-01T08:47:17.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2024-05-13T10:50:48.000Z (6 months ago)
• Last Synced: 2024-05-13T11:55:34.522Z (6 months ago)
• Topics: quarto, workshop
• Language: Lua
• Homepage: https://nrennie.github.io/LU-psychology-quarto
• Size: 10.7 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Introduction to Quarto for Research

Date: May 9, 2024

Tutor: Nicola Rennie

GitHub: [github.com/nrennie/LU-psychology-quarto](https://github.com/nrennie/LU-psychology-quarto)

Slides: [nrennie.github.io/LU-psychology-quarto](https://nrennie.github.io/LU-psychology-quarto)

## Session overview

### Part 1 (morning)

* Introduction to Quarto

  * What is Quarto?

  * Why is Quarto good for reproducible research?

  * How does Quarto compare to alternatives?

* Making your first Quarto document

  * Output types

  * YAML options (document properties)

  * Document rendering

  * Quarto in RStudio

* Document content

  * External image files

  * Tables

  * Links

  * Markdown syntax: Bullet points, lists, bold text

* Code blocks (maybe afternoon depending on time)

  * Plots

  * Tables

### Part 2 (afternoon)

* Referencing

  * Inline code and referencing results

  * Results references in figure captions

  * Figure and table references

  * Cross references

  * Citations

* Formatting

  * Journal templates (e.g. APA style)

  * Output formats (Word, LaTeX)

  * Manuscript format

* Collaborating with Quarto

  * GitHub

  * {trackdown}

  * VSCode Live Share

* Discussion

  * Nice features

  * Tricky things

  * Quarto and R versions

  * {targets}

  * Converting from R Markdown

## Prerequisites

### Quarto

* You should have a working installation of Quarto.

  * If you have installed a recent version of RStudio IDE (after Jul 2022), you should already have Quarto installed.

  * If you click on the **Terminal** tab in RStudio (next to the **Console**) and run `quarto --version` this will tell you if Quarto is installed and what version you have.

  * You can also install a more recent version if required. See [quarto.org/docs/get-started](https://quarto.org/docs/get-started/) to download Quarto. 

  * You should also have access to a text editor or IDE (e.g. RStudio, VSCode, Emacs). RStudio is recommended for this workshop.

  * If you have any issues installing R, RStudio, or Quarto, you may wish to use [posit.cloud](https://posit.cloud/) for the session.

### R

* You should have a working installation of R.

* You do **not** need to be experienced in R for this workshop. Code examples will be provided.

* Packages used: 

  * {psych} (for `bfi` data only). This can be read in with `bfi <- read.csv("https://vincentarelbundock.github.io/Rdatasets/csv/psych/bfi.csv")` instead.

  * {tinytables} (for making tables but you can use {knitr} instead)

### Other

* You may wish to bring a laptop charger as the workshop will run for most of the day.