Materials for the RSE Conf 2022 workshop: "Quarto: a Library to run them all?", led by Carlos Cámara-Menoyo, James Tripp and Cagatay Turkay.
Using literate programming is a widespread practice amongst data scientists. Chances are that you may have come across, or even used, one of the two more mature projects, Rmarkdown or jupyter notebooks, to present results, do exploratory analysis, author academic articles or complete books or even perform complete analyses. While both solutions can be used with multiple programming languages, the decision of whether to use one or the other is almost certain to be exclusively based on that: the vast majority of R users will opt for Rmarkdown while python users will favour jupyter notebooks. At least until now, with Quarto being mature enough to become a game-changer. Quarto is a language-agnostic software that it's based on pandoc to render files combining markdown and code into multiple ranges of formats and outputs. This means it can be used with either R, Phython, Julia or Observable without any other dependencies. This collaborative workshop will be organised around 3 stages:
Participants in this workshop will have enough depth of breath and practice to evaluate how feasible is to use Quarto in different scenarios and, ultimately, if it can become the one-tool for reproducible scientific publishing, regardless of your language of choice.
In order to take part in this workshop you will need to have the following software in your laptop:
All the software used in this workshop is available for GNU/Linux, Windows and MacOS.
git clone git@github.com:WarwickCIM/quarto-workshop.git
To be done later.
slides/ <-- Slides for the workshop.
cases/ <-- Quarto use cases, each case in a folder.
|-- <case_n> <-- Each case should reside in a folder.
|-- template <-- Template for documenting the process.
Thanks goes to these wonderful people (emoji key):
Carlos Cámara 💻 🤔 📢 📖 |
cagatayTurkay 💻 🤔 |
Brian Maher 🧑🏫 |
James Tripp 💻 🤔 📢 |
Eirini Zormpa 💻 |
Heather Turner 💻 |
Alessandro Felder 💻 |
CBress 💻 |
Thomas Arildsen 💻 |
Patrick Roddy 💻 |
Jordan Byers 💻 |
Ibrahim Animashaun 💻 |
It is a collaborative project, this means that: A) Contributions of any kind are welcome!; and B) following the all-contributors specification and being grateful is a requirement.
If you believe you must be credited, please do it in this issue.
Please, introduce yourselves in this issue