-
Notifications
You must be signed in to change notification settings - Fork 3
/
index.qmd
67 lines (46 loc) · 3.58 KB
/
index.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
---
title: "1. Welcome to the Quarto Workshop"
sidebar: true
---
Welcome to the **Quarto workshop**, initially designed for [LMU OSC Summer School 2023](https://lmu-osc.github.io/OSC-Open-Research-Summer-School-2023/) and [LMU & MPG Open Science Summer School 2024](https://osip.mpdl.mpg.de/lmu-mpg-open-science-summer-school-2024/).
## Structure and Workflow of the Workshop
This is a **self-paced tutorial** of about **2 hours** (when skipping the advanced exercises) aimed at **early-career researchers**.
It covers the absolute basics of the scientific and technical publishing system [Quarto](https://quarto.org/) while using [R in RStudio](https://quarto.org/docs/tools/rstudio.html).
The workshop is structured in 5 consecutive parts, which you can navigate to at the top of the website, in the sidebar or using the arrows at the bottom of each page:
1. [Welcome](index.qmd) to the Quarto Workshop (**you are here now**)
2. [Quarto Tutorials](quarto_tutorials.qmd) from the official Quarto project
3. [Tips and Comments](comments.qmd) from our own experiences of using Quarto
4. [Advanced Exercises](quarto_exercises.qmd) that are more challenging than the beginner Quarto tutorials
5. [Links](links.qmd) to further resources
The Quarto project provides well written tutorials ([Quarto "Getting Started"](https://quarto.org/docs/get-started/)) and online documentation ([Quarto "Guide"](https://quarto.org/docs/guide/)).
Instead of reinventing the wheel, we will heavily link to these resources (and complement them with our own comments and some advanced exercises).
## What is Quarto?
The official [Quarto](https://quarto.org/) website reads:
::: {.callout-tip appearance="minimal" icon=false}
## Quote:
An open-source scientific and technical publishing system
- Author using Jupyter notebooks or with plain text markdown in your favorite editor.
- Create dynamic content with Python, R, Julia, and Observable.
- Publish reproducible, production quality articles, presentations, websites, blogs, and books in HTML, PDF, MS Word, ePub, and more.
- Share knowledge and insights organization-wide by publishing to Posit Connect, Confluence, or other publishing systems.
- Write using Pandoc markdown, including equations, citations, crossrefs, figure panels, callouts, advanced layout, and more.
Analyze. Share. Reproduce. You have a story to tell with data—tell it with Quarto.
:::
These features make Quarto an extremely useful tool for researchers to:
- write reproducible research reports, presentations or scientific articles
- create personal of project websites
- publish tutorials, textbooks, or other educational resources online
- and much more...
If you have not seen many examples yourself, go to the official [Quarto Gallery](https://quarto.org/docs/gallery/), the [Quarto Blog](https://quarto.org/docs/blog/), or have a look at the following presentation for a few examples, where we have used Quarto in our own work:
```{=html}
<iframe class="slide-deck" width="100%" height="500" src="presentation.html"></iframe>
```
<!-- ```{.markdown code-preview="presentation.qmd" width="780" height="500"} -->
<!-- ``` -->
::: {.callout-note collapse="true"}
## Live coding example
If you have attended the in-person workshop, you can download the result of the live coding example here:
{{< downloadthis _live-coding-example.zip dname="live-coding-example" label="Download .zip file">}}
:::
## Learn how to use Quarto yourself
When you have finished reading this short introduction and want to learn how to use Quarto for your own projects, go to the [Quarto Tutorials](quarto_tutorials.qmd) page next. :computer: :scream_cat: