Setting up environment for building assets
These notes assume as baseline a Debian trixie system
(i.e. Debian testing as of February 2025).
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.
Simplest is to get a preliminary build
of the upcoming Debian package
and install it with sudo dpkg -i radicle_*.deb.
Alternatively build and install from upstream source.
When Radicle is installed (regardless of method),
initialize once your local system-wide identity:
rad auth
You might also want to familiarize yourself with radicle
through the guide at the upstream website.
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:...
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.
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
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 JAR file 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
