Land_Atmosphere_interactions_notes

Repository containing the practical material for the course of Land-Atmosphere Interactions. This course materials is also hosted as a website at https://h-cel.github.io/land-atmosphere-interactions-public/.

The assignment (without solutions) can be found on a public repository. The solutions are in a private repository, access to which can be granted upon contacting me.

Installation instructions (local setup)

First, make a local copy of this repository using

git clone https://github.com/h-cel/land-atmosphere-interactions-public.git

or download as zip file and unzip. In each case, make sure to navigate inside the land-atmosphere-interactions-public folder before executing any of the command line interface (CLI) instructions below.

Go to the Quarto download page and download Quarto for your operating system (OS). This repository was built using Quarto 1.9.38.

Next, make sure you have (Mini)Conda installed (download links found here). Next open your CLI (or Anaconda prompt) and type:

conda env create -f environment.yml
conda activate la_interactions_quarto

Next, it is recommended that following Quarto tools are installed:

• In this repository, a final output is rendered to pdf. Therefore, a LaTeX distribution is needed. Install the TinyTex distribution, a lightweight version of TeX Live, with following command in the CLI: quarto install tinytex. This should be more straightforward than managing your own Tex distribution.
• To render the diagrams, made with Mermaid, quarto needs the Chrome or Edge browser. If you don't have Chrome or Edge in your local device and prefer to keep it that way, you can install a Chrome Headless Shell via quarto in the CLI with quarto install chrome-headless-shell.

There are several ways to use Quarto, but here VS Code is used as interface. With VS Code installed for your OS, perform the following:

1. Under extensions, install the Quarto extension.
2. Follow the instructions here and select la_interations_quarto as your Python interpreter for VS Code.
3. To have a nice preview of your .qmd quarto document, use Ctrl + Shift + k. After modifying the .qmd document, use the same key combination to render the preview again. Alternatively, run quarto preview --no-browser in the CLI (this should normally eliminate the need to use Ctrl + Shift + k repeatedly).
4. To render the entire set of documents as one .pdf, type quarto render in the command line. Under the _book folder, you can then find the rendered .pdf.

For more details on how to use Quarto with VS Code, see the Quarto documentation.

Github Actions for automatic publishing

With publish.yml, the repository is automatically rendered and published as a website. For more information on how this works, see the README of the Quarto template repository or the Quarto documentation on publishing.