# Setting up environment for building assets

## System requirements

### Debian

Install packages required for the default make target:

```
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
sudo apt install pandoc-filter-diagram plantuml inkscape
```

Optionally install additional packages
e.g. for secondary make targets:

```
sudo apt install git texlive-binaries-sse2
sudo apt install git man-db
sudo apt install bibclean libpath-tiny-perl libipc-run3-perl
sudo apt install python-rdflib-tools xdot
sudo apt install latexdiff
```

### Quarto

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

### 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
```

### Fonts

Install fonts included with project to personal font directory:

```
mkdir --parents ~/.fonts
cp --target-directory ~/.fonts fonts/*/opentype/*
```

### PlantUML

Debian-packaged PlantUML is [too old](https://bugs.debian.org/1004135),
so the main jar file needs to be replaced with a newer working one.

Download newest GPL version of PlantUML
from [their website](https://plantuml.com/download).

Replace Debian-packaged plantuml with the downloaded file:

```
sudo mv /usr/share/plantuml/plantuml.jar /usr/share/plantuml/plantuml.jar.orig
sudo cp -T ~/Downloads/plantuml-*.jar /usr/share/plantuml/plantuml.jar
sudo chown root: /usr/share/plantuml/plantuml.jar
```

### JabRef

Debian-packaged JabRef is [too old](https://bugs.debian.org/877718),
so upstream-provided package is used instead.

Download and install newest stable version of JabRef
from [their website](https://jabref.org/#download).

Set `File → Preferences → Linked files → Main library`
to the path of your local library,
e.g. `/home/jonas/Projects/RUC/LIB`.