aboutsummaryrefslogtreecommitdiff
path: root/SETUP.md
blob: 48cb5c83b7e06a87437c753df5a0af654994b3fa (plain)

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 bat
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.

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, so the main jar file needs to be replaced with a newer working one.

Download newest GPL version of PlantUML from their website.

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, so upstream-provided package is used instead.

Download and install newest stable version of JabRef from their website.

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