From b588215bdbd0bfacbb946e413396e069d26bebe2 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Sat, 15 Mar 2025 07:32:58 +0100 Subject: rename file SETUP -> _SETUP --- SETUP.md | 113 --------------------------------------------------------------- 1 file changed, 113 deletions(-) delete mode 100644 SETUP.md (limited to 'SETUP.md') diff --git a/SETUP.md b/SETUP.md deleted file mode 100644 index 22f9f25..0000000 --- a/SETUP.md +++ /dev/null @@ -1,113 +0,0 @@ -# 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]. - -[Debian package]: - -[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][Radicle User Guide]. - -[Radicle User Guide]: - -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][Quarto landing page]. - -[Quarto landing page]: - -## 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](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 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 -``` -- cgit v1.2.3