Updated build

Author: TheNewAutonomy

.DS_Store

@@ -0,0 +1,14 @@
+.git
+.github
+build
+
+*.pdf
+*.bbl
+*.blg
+*.aux
+*.log
+*.out
+*.toc
+*.synctex.gz
+
+.DS_Store

.dockerignore

@@ -0,0 +1,35 @@
+name: Build PDF
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install TeX toolchain
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            latexmk \
+            texlive-latex-base \
+            texlive-latex-extra \
+            texlive-fonts-recommended \
+            texlive-pictures \
+            texlive-bibtex-extra
+
+      - name: Build PDF
+        run: |
+          make pdf
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: catalyst-technical-whitepaper
+          path: |
+            build/*.pdf
+            build/*.log

.github/workflows/build-pdf.yml

@@ -1,20 +1,39 @@
 
+## LaTeX build artifacts
 *.aux
-
-*.log
-
+*.bbl
+*.bcf
 *.blg
-
-*.gz
-
+*.fdb_latexmk
+*.fls
+*.log
 *.out
-
+*.run.xml
+*.synctex.gz
 *.toc
 
-.vs/ProjectSettings.json
-
-.vs/slnx.sqlite
-
-.vs/VSWorkspaceState.json
-
-.vs/whitepaper/v16/.suo
+## Common LaTeX extras
+*.lof
+*.lot
+*.nav
+*.snm
+*.vrb
+*.xdv
+*.idx
+*.ilg
+*.ind
+*.ist
+*.acn
+*.acr
+*.alg
+*.glg
+*.glo
+*.gls
+_minted*
+
+## Build output directory (used by Makefile/CI)
+build/
+
+## OS / editor artifacts
+.DS_Store
+.vs/

.gitignore

@@ -0,0 +1,24 @@
+## Contributing
+
+Thanks for taking the time to contribute.
+
+### Scope
+
+This repository contains the Catalyst whitepaper sources and build tooling.
+
+- Please keep changes focused and easy to review.
+- Avoid reformat-only changes unless they are necessary for the task at hand.
+
+### Workflow
+
+- Create a branch from `master`.
+- Open a pull request with a short summary and, if applicable, a note on how you built the PDF locally.
+
+### Building locally
+
+See the "Building (local)" section in `README.md` and run:
+
+```bash
+make pdf
+```
+

CONTRIBUTING.md

@@ -0,0 +1,17 @@
+FROM ubuntu:24.04
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    make \
+    latexmk \
+    texlive-latex-base \
+    texlive-latex-extra \
+    texlive-fonts-recommended \
+    texlive-pictures \
+    texlive-bibtex-extra \
+  && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /work
+
+CMD ["make", "pdf"]

Dockerfile

@@ -0,0 +1,30 @@
+TEX ?= catalyst-technical-whitepaper-new.tex
+OUTDIR ?= build
+
+.PHONY: help pdf clean distclean
+
+help:
+	@echo "Targets:"
+	@echo "  make pdf        Build PDF from $(TEX) into $(OUTDIR)/"
+	@echo "  make clean      Remove intermediate LaTeX artifacts in $(OUTDIR)/"
+	@echo "  make distclean  Remove $(OUTDIR)/ completely"
+	@echo ""
+	@echo "Variables:"
+	@echo "  TEX=<file.tex>  Choose entrypoint (default: $(TEX))"
+	@echo "  OUTDIR=<dir>    Output directory (default: $(OUTDIR))"
+
+$(OUTDIR):
+	@mkdir -p "$(OUTDIR)"
+
+pdf: $(OUTDIR)
+	@command -v latexmk >/dev/null 2>&1 || ( \
+		echo "latexmk not found. Install TeX Live + latexmk (see README.md)."; \
+		exit 127; \
+	)
+	latexmk -pdf -interaction=nonstopmode -halt-on-error -outdir="$(OUTDIR)" "$(TEX)"
+
+clean:
+	@if [ -d "$(OUTDIR)" ]; then latexmk -c -outdir="$(OUTDIR)" "$(TEX)" || true; fi
+
+distclean:
+	@rm -rf "$(OUTDIR)"

Makefile

@@ -16,6 +16,42 @@ Setting up and using LaTeX can be found here:
 
 https://github.com/catalyst-network/whitepaper/wiki/Using-and-Compiling-LaTeX
 
+## Building (local)
+
+This repository is a LaTeX project. The recommended entrypoint is:
+
+- `catalyst-technical-whitepaper-new.tex`
+
+### Prerequisites (Ubuntu/Debian)
+
+Install a TeX distribution and `latexmk`:
+
+```bash
+sudo apt update
+sudo apt install -y latexmk texlive-latex-base texlive-latex-extra texlive-fonts-recommended texlive-pictures texlive-bibtex-extra
+```
+
+### Build
+
+```bash
+make pdf
+```
+
+Outputs are written to `build/` (see `Makefile`).
+
+### Build (Docker)
+
+If you prefer not to install TeX locally:
+
+```bash
+docker build -t catalyst-whitepaper .
+docker run --rm -v "$PWD:/work" catalyst-whitepaper
+```
+
+### Alternative entrypoints
+
+- `catalyst-technical-whitepaper.tex` exists, but may not build in some revisions depending on which consensus subsection file is present.
+
 
 ## File Format
 
@@ -29,4 +65,4 @@ Each section and subsection is split into separate `.tex` files for ease of edit
 
 The paper that covers the PoA Test net and the minor changes involved with that can be found [here](https://github.com/catalyst-network/whitepaper/tree/PoA-paper-version). 
 
-Differences are primeraly in the consensus algorithm with regards to producer selection.  
+Differences are primarily in the consensus algorithm with regards to producer selection.