Summary and Schedule
Goal:
The main goal of this lesson is to introduce the user to Quarto and show the benefits of using this program in the process of scientific publishing. During the lesson, the user will learn the basic usages of Quarto and how they can be applied throughout the process of writing and publishing a scientific paper.
Several core features of Quarto, like easy switching between formats, integration of code and built-in bibliography, offer users in the humanities a solid foundation for the writing and publishing of papers or the distribution of data.
Throughout the lesson we will walk throught the steps needed to publish a scientific paper about the distribution of artworks in the metropolitain Museum of Modern Art.
At the end of the lesson, you should be able to create simple scientific papers and websites using Quarto, which include python code and visualisations.
Lesson Structure:
The Lesson is subdivided into several parts: - A brief Introduction into Quarto and its history - A guide through Quartos basic features and tools. This includes the Markdown language, YML headers and the implementation of python-based code. - A guide on how to convert a PDF based Quarto document into a html-based website - An introduction into the build-in bibliography feature and its tools
| Setup Instructions | Download files required for the lesson | |
| Duration: 00h 00m | 1. A brief introduction to Quarto |
What is Quarto and how can it be used to publish data? What Options does Quarto give to customize your experience? |
| Duration: 00h 00m | 2. Getting started |
How do i open a new Quarto document? What editing modes exist? How do i switch between modes? |
| Duration: 00h 01m | 3. Markdown Basics |
What is Markdown? How do you use Markdown to write in Quarto? What are the most common parts of Markdown syntax? |
| Duration: 00h 02m | 4. An introduction to YAML headers |
What is YAML? How to use a YAML header? What are the most useful Key-Value pairs for a scientific paper? |
| Duration: 00h 04m | 5. Creating and implementing code for visualisations |
How do you implement code in Quarto? How to use code to create visualisations and graphs? How do you annotate visualisations? |
| Duration: 00h 06m | 6. Quarto for PDF and HTML |
What unique options exists for PDFs in Quarto? What unique iptions exists for HTML in Quarto? |
| Duration: 00h 07m | 7. Using the Bibliography |
What is the bibliography feature in Quarto? How do you use and expand the bibliography and citations? How do you implement footnotes? |
| Duration: 00h 08m | 8. Creating a simple website with Quarto |
How to create a website using Quarto? What seps and components are necessary to create a website with Quarto? |
| Duration: 00h 08m | Finish |
The actual schedule may vary slightly depending on the topics and exercises chosen by the instructor.
Quarto can be used through a variety of Coding environments, such as Visual Studio Code, RStudio or a simple Plaintext editor. In this Lesson we will focus on the use of Visual Studio Code, but many if not most functionalities will be similar or identical in other environments.
Software Setup
As we are working in the Visual Studio Code environment, the only step needed to start working with Quarto is the installation and activation of the Quarto extension in VSCode. To do so you need to open the Extension tab in VS Code (Crtl+Shift+X on Windows) and search for Quarto. Now you only need to press “install” in order to activate Quarto in your VSCode.
Getting Help
If you encounter problems installing or running Quarto, a good source of support is the offical webpage of Quarto. Here you can find a plethora of guides and information.
You may also want to check the Stack Overflow [Quarto] tag.