# Setting up environment for building assets

These notes assume as baseline a Debian system.
It is tested on Debian unstable and Debian testing,
and should work also with Debian stable.

## Core

The setup required for accessing and sharing changes to the project.

### Debian

Install these official Debian packages:

```
sudo apt install git
```

### Radicle

Download and install Radicle.

One alternative is to get the custom distributed draft deb-file
and install it with `sudo dpkg -i radicle_*.deb`.

Alternatively manually install the contents of the tarball
from [their website](https://radicle.xyz/download).

When Radicle is installed (regardless of method),
initialize your local identity:

```
rad auth
```

You might also want to familiarize yourself with radicle
through the guide at [their website](https://radicle.xyz/guides/user).

When Radicle is installed,
clone this project via the Radicle peer-to-peer network:

```
rad clone rad:z3aazGQX558YLccJ4qW2hYD1umiUy
```

If you need write access to this project,
share your Radicle identity with existing project members.
You can get your identity like this:

```
rad self --did
```

Existing project members (not you, yet) can then grant you access:

```
rad id update --delegate did:key:...
```

### hedgedoc-cli

Clone the code project hedgedoc-cli:

```
mkdir --parents ~/Projects
cd ~/Projects
git clone https://github.com/hedgedoc/cli hedgedoc-cli
```

Add link in personal bin folder to cloned CLI script:

```
mkdir --parents ~/bin
cd ~/bin
ln --symbolic --target-directory=. ../Projects/hedgedoc-cli/bin/hedgedoc
```

## Manuscript

The setup required for building the default make target.

### Debian

Install these official Debian packages:

```
sudo apt install make texlive-luatex texlive-latex-extra texlive-fonts-extra
sudo apt install texlive-lang-european
sudo apt install citation-style-language-styles
```

### Quarto

Download and install newest stable version of Quarto
from [their website](https://quarto.org/docs/get-started/).

## Miscellaneous

Optional setup -
e.g. needed for secondary make targets.

### Debian

Install these official Debian packages:

```
sudo apt install texlive-binaries-sse2
sudo apt install bat
```