Files
the-job-machine/07_bewerbung-typst/README.md
T

73 lines
2.8 KiB
Markdown

# Bewerbungsunterlagen in Typst
Dieser Ordner ist unabhängig von den LaTeX-Quellen im übergeordneten Projekt.
Er enthält die Typst-Dokumente, die gemeinsame Vorlage, alle benötigten Schriften
und die Unterschrift.
Die beiden unabhängig bearbeitbaren Varianten liegen in `Admin/` und
`Senior Developer/`. Jedes Verzeichnis enthält ein Anschreiben und einen
Lebenslauf als `.typ` sowie die daraus erzeugten PDFs. Beide Varianten wurden
zunächst mit den bestehenden Entwicklertexten angelegt; die Admin-Texte können
anschließend angepasst werden.
## Voraussetzungen
- Typst 0.15 oder neuer
- Python 3 (für die gebündelte Ausgabe im Watch-Modus)
- `make` (optional; die Typst-Befehle können auch direkt ausgeführt werden)
## PDFs bauen
Im Ordner `07_bewerbung-typst`:
```sh
make all
```
Die vier Ergebnisse liegen direkt neben ihren Typst-Quelldateien in `Admin/`
und `Senior Developer/` und tragen denselben Namen mit der Endung `.pdf`.
Die PDFs werden von Git ignoriert.
`make all` baut fehlende oder veraltete PDFs. Auch `make` ohne Argumente führt
dieses Ziel aus. `make clean` entfernt die vier erzeugten PDFs.
## Dateien umbenennen
Die gemeinsamen Quelldateinamen stehen ausschließlich in den Variablen
`COVERLETTER_SRC` und `CV_SRC` am Anfang des `Makefile`.
Nach einer Umbenennung in beiden Rollenverzeichnissen diese Angaben entsprechend anpassen.
Build, Watch-Modus und PDF-Namen verwenden automatisch diese Konfiguration.
Einen laufenden Watch-Modus nach Änderungen am Makefile neu starten.
Vor dem Lesen oder Bearbeiten der Dokumente immer zuerst die aktuellen
Dateinamen im Makefile nachschlagen. Die daraus erzeugten Typst-Befehle
lassen sich ohne Ausführung anzeigen:
```sh
make -nB all
```
## Automatisch bei Änderungen bauen
Der Watch-Modus baut beim Start alle vier Dokumente und überwacht anschließend
ihre Quellen einschließlich der importierten Vorlagen. Bei Änderungen werden
nur die betroffenen PDFs neu erzeugt; Änderungen an `personal.typ` oder
`template.typ` betreffen alle vier Dokumente:
```sh
make watch
```
Die Überwachung läuft, bis sie mit `Ctrl+C` beendet wird. Dabei werden alle
vier Watch-Prozesse beendet. Die drei Befehle sind `make all`, `make clean`
und `make watch`.
`watch.py` bündelt die Ausgabe zeilenweise und stellt jeder Meldung den
Dokumentpfad voran, damit gleichzeitige Status- und Fehlermeldungen lesbar bleiben.
Gemeinsame Kontaktdaten werden in `personal.typ` gepflegt. Farben, Kopf- und
Fußzeilen sowie wiederverwendbare CV-Komponenten stehen in `template.typ`.
Diese Dateien sowie `fonts/` und `assets/` werden von beiden Varianten gemeinsam
verwendet. Das Makefile setzt `--root .`, damit Typst aus den Unterverzeichnissen
auf diese Ressourcen zugreifen kann.
`personal.typ` und `template.typ` müssen deshalb im Typst-Hauptverzeichnis bleiben.