2 Installing
There are a few programs that are required to use this template to create a workshop:
- uv: A tool for managing Python environments and running commands.
- Python: Required by Copier, the template tool.
- Copier: A template tool for making new workshops in a standardised and structured way.
You can use uv to install these required programs, so install that first. After you’ve installed uv, you can use uv to install Copier, which is the program that will actually take the template and set it up on your computer.
Terminal
uv tool install copieruv will also install Python for you when you install Copier. After that, in order to do the next steps and to use the workshop repository created from the template, you need to install:
- Git: For version control and setting up Git to track the newly created workshop.
- Quarto: A scientific and technical publishing system built on Pandoc. The website built with this template is created with Quarto, and the workshop created from this template is also set up to use Quarto too.
- gh cli: For managing GitHub repositories and settings from the command line. There are some post-creation steps we’ve included that use gh to simplify setting up a GitHub repository for the workshop.
We strongly recommend installing and using these tools to help make it easier to develop the workshop material created with this template:
Lychee: A link checker that we include in the
justfilefor checking for broken links in the files.just: A build and development management tool that helps with running common build and check tasks. You can install it using uv.
Terminal
uv tool install rust-justJarl R linter and Air R formatter: If you want to check and format R code inside of Quarto files for R-based workshops to make sure it’s correct, you can install these tools using the justfile recipe to install development dependencies:
Terminal
just install-dev-deps