Use Your Python to Create Documents and Reproducible Reports with Quarto

Quarto is an open-source technical publishing system that enables the creation of dynamic, reproducible documents, presentations, dashboards, and books. This workshop will introduce Quarto’s powerful features, allowing participants to seamlessly blend python code, text, and visualisations into professional-quality outputs.

The goal of this workshop is to bring a powerful and versatile tool to the scientist, or business analyst, or the plain ordinary programmer and allow them to be exceptional with their programming. At the end of the workshop, one will have identified at least one immediate use case to apply what they would have learned.

Workshop Plan

1. Introduction to Quarto

• Why Quarto?


• Basic structure of a Quarto document

2. Building Dynamic Documents

• Combining your Python code and prose for narrative-driven analysis


• Including dynamically generated plot figures


• Render to multiple formats

3. A quick tour of the multiple places Quarto can quickly take your Python code to

• Documents


• Dashboards


• Websites


• Presentations


• Books


• Jupyter Notebooks

4. Unleash the power of parameterised reports

• Create a parameterised template


• Programmatically generate multiple reports

Audience

The science and engineering crowd would be well served by this workshop, but only a basic understanding of Python and Markdown is assumed. It is open and useful to everyone. More experienced programmers will also find as much value, since the content is structured to be accessible without being limiting.

Prerequisites

Please follow the following instructions to prepare for the workshop:

• Download Quarto and follow the instructions specific for your operating system.


• We shall be using VSCode for this workshop, download it in case you don’t have it installed.


• Install the Quarto VSCode extension.