Compare commits

...

3 Commits

Author SHA1 Message Date
Peter Adam
74269c4fbb Add back side template and update README with event.yml workflow
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-28 10:53:36 +01:00
Peter Adam
84d8cfc2dc Add example YAML event configuration and update .gitignore
- Introduce `event.yml.example` providing a template for event-level configuration.
- Extend `.gitignore` to include `event.yml` to prevent committing real event data.
2026-02-28 10:47:31 +01:00
Peter Adam
9c4c7c6ccb Refactor PDF generation workflow, integrate YAML-based event config, and simplify Makefile scripts.
- Replace `generate-personalized` with unified `generate` target in Makefile, supporting event config integration.
- Add YAML parsing to `generate_cards.py` for event-level placeholders and back side generation.
- Update templates to include `EVENT_*` placeholders and dynamic content rendering.
- Simplify `build` and `build-personalized` targets; consolidate redundant logic.
- Enhance `make help` documentation for updated workflow.
- Adjust LaTeX formatting for back side templates, removing hardcoded spacing.
2026-02-28 10:43:57 +01:00
8 changed files with 422 additions and 249 deletions

3
.gitignore vendored
View File

@@ -14,6 +14,9 @@
# Real participant data (copy to "Export Brevetkarte.csv" and fill in)
Export Brevetkarte.csv
# Real event data (copy event.yml.example to event.yml and fill in)
event.yml
# Generated files
brevetkarte-personalized.tex

View File

@@ -1,7 +1,6 @@
# Makefile for building Brevet card PDF in Docker
IMAGE_NAME := brevetcard-builder
CONTAINER_NAME := brevetcard-build
TEX_FILE_FRONT := brevetkarte.tex
TEX_FILE_BACK := brevetkarte-rueckseite.tex
TEX_FILE_PERSONALIZED := brevetkarte-personalized.tex
@@ -10,23 +9,20 @@ PDF_FILE_BACK := brevetkarte-rueckseite.pdf
PDF_FILE_PERSONALIZED := brevetkarte-personalized.pdf
CSV_FILE := Export Brevetkarte.csv
.PHONY: all build clean build-image build-pdf build-front build-back generate-personalized build-personalized run shell help
.PHONY: all build clean build-image build-front build-back generate build-personalized run shell help
# Default target
all: build
# Build both PDFs (builds image if needed, then compiles)
build: build-image build-front build-back
# Build static demo front side (builds image if needed)
build: build-image build-front
# Build Docker image
build-image:
@echo "Building Docker image..."
docker build -t $(IMAGE_NAME) .
# Compile both PDFs in Docker container
build-pdf: build-front build-back
# Compile front side PDF
# Compile static demo front side PDF
build-front:
@echo "Compiling front side LaTeX to PDF..."
docker run --rm \
@@ -35,8 +31,8 @@ build-front:
pdflatex -interaction=nonstopmode $(TEX_FILE_FRONT)
@echo "PDF generated: $(PDF_FILE_FRONT)"
# Compile back side PDF
build-back:
# Compile back side PDF (always generated from event.yml via generate)
build-back: build-image
@echo "Compiling back side LaTeX to PDF..."
docker run --rm \
-v $(PWD):/workspace \
@@ -44,24 +40,29 @@ build-back:
pdflatex -interaction=nonstopmode $(TEX_FILE_BACK)
@echo "PDF generated: $(PDF_FILE_BACK)"
# Generate personalized cards from CSV
generate-personalized:
@echo "Generating personalized cards from $(CSV_FILE)..."
# Generate all tex files from CSV + event.yml
generate:
@echo "Generating cards from $(CSV_FILE) + event.yml..."
@if [ ! -f "$(CSV_FILE)" ]; then \
echo "Error: $(CSV_FILE) not found!"; \
exit 1; \
fi
python3 generate_cards.py
@echo "Generated $(TEX_FILE_PERSONALIZED)"
# Build personalized cards PDF
build-personalized: generate-personalized build-image
@echo "Compiling personalized cards to PDF..."
# Build personalized front + event back side PDFs
build-personalized: generate build-image
@echo "Compiling personalized front side to PDF..."
docker run --rm \
-v $(PWD):/workspace \
$(IMAGE_NAME) \
pdflatex -interaction=nonstopmode $(TEX_FILE_PERSONALIZED)
@echo "PDF generated: $(PDF_FILE_PERSONALIZED)"
@echo "Compiling back side to PDF..."
docker run --rm \
-v $(PWD):/workspace \
$(IMAGE_NAME) \
pdflatex -interaction=nonstopmode $(TEX_FILE_BACK)
@echo "PDF generated: $(PDF_FILE_BACK)"
# Run container interactively
run:
@@ -95,15 +96,14 @@ help:
@echo "Brevet Card PDF Builder"
@echo ""
@echo "Available targets:"
@echo " make build - Build Docker image and compile both PDFs (default)"
@echo " make build-image - Build Docker image only"
@echo " make build-pdf - Compile both front and back PDFs"
@echo " make build-front - Compile front side PDF only"
@echo " make build-back - Compile back side PDF only"
@echo " make generate-personalized - Generate personalized cards from CSV"
@echo " make build-personalized - Generate and compile personalized cards"
@echo " make shell - Open interactive shell in container"
@echo " make clean - Remove generated files (aux, log, pdf)"
@echo " make clean-all - Remove all files and Docker image"
@echo " make rebuild - Clean everything and rebuild"
@echo " make help - Show this help message"
@echo " make build - Build Docker image and compile static front side (default)"
@echo " make build-image - Build Docker image only"
@echo " make build-front - Compile static demo front side PDF"
@echo " make generate - Generate tex files from CSV + event.yml"
@echo " make build-personalized - Generate and compile front + back side PDFs"
@echo " make build-back - Compile back side PDF (after generate)"
@echo " make shell - Open interactive shell in container"
@echo " make clean - Remove generated files (aux, log, pdf)"
@echo " make clean-all - Remove all files and Docker image"
@echo " make rebuild - Clean everything and rebuild"
@echo " make help - Show this help message"

185
README.md
View File

@@ -2,138 +2,111 @@
LaTeX-basierter Generator für Audax Randonneurs Allemagne Brevetkarten mit Vorder- und Rückseite für den Duplexdruck.
## Schnellstart
```bash
# Alles bauen und beide PDFs erzeugen
make build
# Die PDFs werden erstellt als:
# - brevetkarte.pdf (Vorderseite mit Teilnehmerinfos)
# - brevetkarte-rueckseite.pdf (Rückseite mit Kontrollen)
```
## Voraussetzungen
- Docker
- Make
- Python 3 + PyYAML (`pip install pyyaml`)
## Konfigurationsdateien
Vor dem ersten Build zwei Dateien aus den Beispielen anlegen und befüllen:
```bash
cp "Export Brevetkarte.csv.example" "Export Brevetkarte.csv"
cp event.yml.example event.yml
```
Beide Dateien sind in `.gitignore` eingetragen und werden nicht ins Repository übernommen.
### event.yml
Enthält alle veranstaltungsspezifischen Daten:
```yaml
event:
title: "Name der Veranstaltung"
km: "200"
date: "1. Januar 2025"
start_location: "Stadt, Ort"
club: "Clubname"
club_nr: "000000"
startzeit: "8:00"
backside:
"1_1": |
\vspace{2mm}
\textbf{Nr. 1:} Km 0 -- Startort\\
...
"1_2": "" # leer = Stempelfeld
...
```
Die `backside`-Sektion belegt die 12 Zellen der Rückseite (3 Zeilen × 4 Spalten, Schlüssel `"Zeile_Spalte"`). Der Inhalt ist freies LaTeX. Leere Zellen (`""`) dienen als Stempelfelder.
### Export Brevetkarte.csv
Teilnehmerdaten im Format:
```
Startnr, Nachname, Vorname, Straße, PLZ, Ort, Land, Medaille
```
Siehe `Export Brevetkarte.csv.example` für das vollständige Format.
## Verwendung
### Beide PDFs bauen
### Personalisierte Karten erzeugen und bauen
```bash
make build
make build-personalized
```
Dies führt folgende Schritte aus:
1. Docker-Image mit TeX Live bauen
2. `brevetkarte.tex` zu `brevetkarte.pdf` kompilieren (Vorderseite)
3. `brevetkarte-rueckseite.tex` zu `brevetkarte-rueckseite.pdf` kompilieren (Rückseite)
Führt folgende Schritte aus:
1. `generate_cards.py` liest `Export Brevetkarte.csv` + `event.yml`
2. Erzeugt `brevetkarte-personalized.tex` (Vorderseite, eine Karte pro Teilnehmer)
3. Erzeugt `brevetkarte-rueckseite.tex` (Rückseite mit Kontrollpunkten aus event.yml)
4. Kompiliert beide .tex-Dateien zu PDFs
### Einzelne Seiten bauen
### Einzelne Schritte
```bash
# Nur Vorderseite bauen
make build-front
# Nur tex-Dateien generieren (ohne Docker)
make generate
# Nur Rückseite bauen
# Nur Rückseite kompilieren (nach generate)
make build-back
# Beide Seiten bauen
make build-pdf
# Statische Demo-Vorderseite bauen (ohne CSV, für Tests)
make build-front
```
### Personalisierte Karten aus CSV
```bash
# 1. Beispiel-CSV kopieren und Teilnehmerdaten eintragen
cp "Export Brevetkarte.csv.example" "Export Brevetkarte.csv"
# "Export Brevetkarte.csv" mit den Teilnehmern befüllen
# 2. Personalisierte Karten erzeugen und bauen
make build-personalized
# Ausgabe: brevetkarte-personalized.pdf
```
Die CSV-Datei `Export Brevetkarte.csv` wird nicht von git erfasst (sie kann personenbezogene Daten enthalten). Die Datei `Export Brevetkarte.csv.example` zeigt das erwartete Format.
### Weitere Befehle
```bash
# Nur das Docker-Image bauen
make build-image
# Interaktive Shell im Container öffnen
make shell
# Erzeugte Dateien löschen (.aux, .log, .pdf)
make clean
# Alles löschen inkl. Docker-Image
make clean-all
# Von Grund auf neu bauen
make rebuild
# Hilfe anzeigen
make help
make build-image # Docker-Image bauen
make shell # Interaktive Shell im Container
make clean # Erzeugte Dateien löschen (.aux, .log, .pdf)
make clean-all # Alles löschen inkl. Docker-Image
make help # Alle Befehle anzeigen
```
## Dateien
- `brevetkarte.tex` - LaTeX-Quelle für die Vorderseite (zwei identische Blanko-Karten)
- `brevetkarte-template.tex` - Vorlage für personalisierte Karten (Platzhalter werden aus CSV ersetzt)
- `brevetkarte-rueckseite.tex` - LaTeX-Quelle für die Rückseite (Kontrollen)
- `Export Brevetkarte.csv.example` - Beispiel-CSV mit dem Teilnehmerdatenformat
- `generate_cards.py` - Erzeugt `brevetkarte-personalized.tex` aus CSV und Vorlage
- `cyclist-logo.png` - Audax Randonneurs Logo
- `Dockerfile` - Docker-Image-Definition (debian:bookworm-slim + TeX-Live-Pakete)
- `Makefile` - Build-Automatisierung
## Ausgabe
### Vorderseite (brevetkarte.pdf)
Enthält zwei identische Brevetkarten, die in der Mitte geschnitten werden können. Jede Karte enthält:
- Teilnehmerinformationen (Name, Adresse usw.)
- Veranstaltungsdetails (200 km „Auf eine Pommes nach Belgien")
- Randonneur-Mondiaux-Regeln
- Homologationsbereich
- Startzeit: 8:30
### Rückseite (brevetkarte-rueckseite.pdf)
Enthält die Kontrollentabelle (4 Spalten × 6 Zeilen):
- **Zeilen 13**: Kontrollen für die obere Karte
- Nr. 1: Start (Km 0 Unisport, Bonn)
- Nr. 2: Km 57 Nationalpark-Tor, Heimbach
- Nr. 3: Km 100 Friterie „Au Petit Creux", Waimes
- Nr. 4: Km 165 Mahlberg
- Nr. 5: Km 205 Ziel (Unisport, Bonn)
- **Zeilen 46**: Kontrollen für die untere Karte (wie oben, aber Nr. 5: Km 214)
- Leere Spalten für Stempel/Unterschriften
- Kontrollfrage zur Verifikation
| Datei | Beschreibung |
|---|---|
| `event.yml.example` | Vorlage für Veranstaltungsdaten (→ als `event.yml` kopieren) |
| `Export Brevetkarte.csv.example` | Vorlage für Teilnehmerdaten (→ als `Export Brevetkarte.csv` kopieren) |
| `brevetkarte-template.tex` | Vorlage Vorderseite (Platzhalter aus CSV + event.yml) |
| `brevetkarte-rueckseite-template.tex` | Vorlage Rückseite (Zellplatzhalter aus event.yml) |
| `brevetkarte.tex` | Statische Demo-Vorderseite (ohne Personalisierung) |
| `generate_cards.py` | Generiert personalisierte .tex-Dateien |
| `cyclist-logo.png` | Audax Randonneurs Logo |
| `Dockerfile` | Docker-Image-Definition (debian:bookworm-slim + TeX Live) |
| `Makefile` | Build-Automatisierung |
## Duplexdruck
Die PDFs sind für den Duplexdruck (beidseitiger Druck) ausgelegt:
1. `brevetkarte.pdf` auf einer Seite drucken
1. `brevetkarte-personalized.pdf` auf einer Seite drucken
2. `brevetkarte-rueckseite.pdf` auf der Rückseite drucken
3. Spalten und Zeilen sind so ausgerichtet, dass:
- Vorderseitenspalten mit Rückseitenspalten übereinstimmen
- Obere Karte (Zeilen 13) mit der oberen Vorderseitenkarte fluchtet
- Untere Karte (Zeilen 46) mit der unteren Vorderseitenkarte fluchtet
4. Blatt horizontal in der Mitte schneiden, um zwei separate Brevetkarten zu erhalten
## Anpassung
`brevetkarte.tex` bearbeiten für die Vorderseite:
- Veranstaltungsname, Datum und Ort
- Distanz (200 km)
- Startzeit
- Vereinsinformationen
- Brevetformat
`brevetkarte-rueckseite.tex` bearbeiten für die Rückseite:
- Kontrollpunkte
- Kontrollzeiten (von/bis)
- Distanzen
- Kontrollfragen
3. Blatt horizontal in der Mitte schneiden → zwei separate Brevetkarten

View File

@@ -0,0 +1,121 @@
\documentclass[a4paper,10pt,landscape]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[landscape,top=0.8cm,bottom=0.8cm,left=0.8cm,right=0.8cm]{geometry}
\usepackage{array}
\usepackage{helvet}
% Set sans-serif font as default
\renewcommand{\familydefault}{\sfdefault}
\setlength{\parindent}{0pt}
\setlength{\tabcolsep}{3pt}
\pagestyle{empty}
\newcommand{\rowheight}{2.833cm}
\begin{document}
% Upper card table (rows 1-3)
\noindent
\begin{tabular}{|p{6.6cm}|p{6.6cm}|p{6.6cm}|p{6.6cm}|}
\hline
% Row 1
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_1_1}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_1_2}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_1_3}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_1_4}}}
\\
\hline
% Row 2
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_2_1}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_2_2}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_2_3}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_2_4}}}
\\
\hline
% Row 3
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_3_1}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_3_2}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_3_3}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_3_4}}}
\\
\hline
\end{tabular}
\vspace{1.8cm}
% Lower card table (rows 1-3, identical)
\noindent
\begin{tabular}{|p{6.6cm}|p{6.6cm}|p{6.6cm}|p{6.6cm}|}
\hline
% Row 1
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_1_1}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_1_2}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_1_3}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_1_4}}}
\\
\hline
% Row 2
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_2_1}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_2_2}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_2_3}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_2_4}}}
\\
\hline
% Row 3
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_3_1}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_3_2}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_3_3}}}
&
\parbox[c][\rowheight][t]{6.5cm}{%
{{CELL_3_4}}}
\\
\hline
\end{tabular}
\end{document}

View File

@@ -12,15 +12,6 @@
\setlength{\tabcolsep}{3pt}
\pagestyle{empty}
% A4 landscape height: 21cm
% Half height: 10.5cm from top of page
% Top margin: 0.8cm
% Row 4 should start at: 10.5 - 0.8 = 9.7cm from start of content
%
% Front side: each card is 8.5cm tall
% So rows 1-3 should be: 8.5cm total (2.833cm each)
% Gap after row 3: 9.7 - 8.5 = 1.2cm
\newcommand{\rowheight}{2.833cm}
\begin{document}
@@ -29,91 +20,79 @@
\noindent
\begin{tabular}{|p{6.6cm}|p{6.6cm}|p{6.6cm}|p{6.6cm}|}
\hline
% Row 1 (Upper card) - height 2.833cm
% Row 1
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 1:} Km 0 - Unisport\\
\textbf{Nr. 1:} Km 0 -- Unisport\\
Nachtigallenweg 86, Bonn\\
\\
\textbf{Kontrollzeit}\\
von: 7:30\\
bis: 8:30
}
bis: 8:30}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty for stamps
\parbox[c][\rowheight][t]{6.5cm}{%
}
&
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 4:} Km 165 Mahlberg Ecke K50,\\
\textbf{Nr. 4:} Km 165 -- Mahlberg Ecke K50,\\
Breitestraße\\
\textbf{Kontrollzeit}\\
von: 13:21\\
bis: 19:30
}
bis: 19:30}
&
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Kontrollfrage:}\\
Wann wurde das Kriegerdenkmal\\
eingerichtet?
}
eingerichtet?}
\\
\hline
% Row 2 (Upper card) - height 2.833cm
% Row 2
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 2:} Km 57 -- Nationalpark-Tor" im\\
\textbf{Nr. 2:} Km 57 -- ,,Nationalpark-Tor`` im\\
alten Bahnhofsgebäude, Heimbach\\
\\
\textbf{Kontrollzeit}\\
von: 9:11\\
bis: 12:21
}
bis: 12:21}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty for stamps
\parbox[c][\rowheight][t]{6.5cm}{%
}
&
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 5:} Km 205 - Unisport\\
\textbf{Nr. 5:} Km 205 -- Unisport\\
Nachtigallenweg 86, Bonn\\
\\
\textbf{Kontrollzeit}\\
von: 13:23\\
bis: 21:00
}
bis: 21:00}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty
\parbox[c][\rowheight][t]{6.5cm}{%
}
\\
\hline
% Row 3 (Upper card) - height 2.833cm
% Row 3
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 3:} Km 100 - Friterie Au Petit\\
Creux" oder Total-Tankstelle, Ecke Rue\\
\textbf{Nr. 3:} Km 100 -- Friterie ,,Au Petit\\
Creux`` oder Total-Tankstelle, Ecke Rue\\
de Botrange/Rue de Charmilles, Waimes\\
\textbf{Kontrollzeit}\\
von: 11:26\\
bis: 15:10
bis: 15:10}
&
\parbox[c][\rowheight][t]{6.5cm}{%
}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty for stamps
\parbox[c][\rowheight][t]{6.5cm}{%
}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty
}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty
\parbox[c][\rowheight][t]{6.5cm}{%
}
\\
\hline
@@ -121,98 +100,86 @@ bis: 15:10
\vspace{1.8cm}
% Lower card table (rows 4-6)
% Lower card table (rows 1-3, identical)
\noindent
\begin{tabular}{|p{6.6cm}|p{6.6cm}|p{6.6cm}|p{6.6cm}|}
\hline
% Row 1 (Lower card)
% Row 1
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 1:} Km 0 - Unisport\\
\textbf{Nr. 1:} Km 0 -- Unisport\\
Nachtigallenweg 86, Bonn\\
\\
\textbf{Kontrollzeit}\\
von: 7:30\\
bis: 8:30
}
bis: 8:30}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty for stamps
\parbox[c][\rowheight][t]{6.5cm}{%
}
&
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 4:} Km 165 Mahlberg Ecke K50,\\
\textbf{Nr. 4:} Km 165 -- Mahlberg Ecke K50,\\
Breitestraße\\
\textbf{Kontrollzeit}\\
von: 13:21\\
bis: 19:30
}
bis: 19:30}
&
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Kontrollfrage:}\\
Wann wurde das Kriegerdenkmal\\
eingerichtet?
}
eingerichtet?}
\\
\hline
% Row 2 (Lower card) - height 2.833cm
% Row 2
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 2:} Km 57 -- Nationalpark-Tor" im\\
\textbf{Nr. 2:} Km 57 -- ,,Nationalpark-Tor`` im\\
alten Bahnhofsgebäude, Heimbach\\
\\
\textbf{Kontrollzeit}\\
von: 9:11\\
bis: 12:21
}
bis: 12:21}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty for stamps
\parbox[c][\rowheight][t]{6.5cm}{%
}
&
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 5:} Km 214 - Unisport\\
\textbf{Nr. 5:} Km 205 -- Unisport\\
Nachtigallenweg 86, Bonn\\
\\
\textbf{Kontrollzeit}\\
von: 13:23\\
bis: 21:00
}
bis: 21:00}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty
\parbox[c][\rowheight][t]{6.5cm}{%
}
\\
\hline
% Row 3 (Lower card) - height 2.833cm
% Row 3
\parbox[c][\rowheight][t]{6.5cm}{%
\vspace{2mm}
\textbf{Nr. 3:} Km 100 - Friterie Au Petit\\
Creux" oder Total-Tankstelle, Ecke Rue\\
\textbf{Nr. 3:} Km 100 -- Friterie ,,Au Petit\\
Creux`` oder Total-Tankstelle, Ecke Rue\\
de Botrange/Rue de Charmilles, Waimes\\
\textbf{Kontrollzeit}\\
von: 11:26\\
bis: 15:10
bis: 15:10}
&
\parbox[c][\rowheight][t]{6.5cm}{%
}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty for stamps
\parbox[c][\rowheight][t]{6.5cm}{%
}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty
}
&
\parbox[c][\rowheight][c]{6.5cm}{%
% Empty
\parbox[c][\rowheight][t]{6.5cm}{%
}
\\
\hline
\end{tabular}
\end{document}
\end{document}

View File

@@ -71,7 +71,6 @@
\item Rücksicht in den Kontrollen
\end{itemize}}
\hspace{0.3cm}$\Rightarrow$ \textbf{\underline{Bei Verstoß keine Wertung!}}\\[0.3cm]
-
};
\node[anchor=south west,text width=6.6cm,font=\small,align=left] at (0.2,-7.0) {
@@ -101,7 +100,7 @@
PLZ/Ort: {{PLZ_ORT}}\\[0.4cm]
Land: {{LAND}}\\[0.4cm]
Medaille: {{MEDAILLE}}\\[0.6cm]
Startzeit: 8:30
Startzeit: {{EVENT_STARTZEIT}}
};
% Column 4 - Event Info (right section)
@@ -110,12 +109,12 @@
};
\node[anchor=north,text width=6.6cm,font=\small,align=center] at (24.15,-2.2) {
\textbf{Auf eine Pommes nach Belgien}\\
Randonnée über \textbf{200} km\\
am \textbf{20. September 2025}\\
mit Start in \textbf{Bonn, Uni-Sportgelände}\\
von \textbf{ARA Rheinland}\\
N° ACP du Club \textbf{111011}
\textbf{{{EVENT_TITLE}}}\\
Randonnée über \textbf{{{EVENT_KM}}} km\\
am \textbf{{{EVENT_DATE}}}\\
mit Start in \textbf{{{EVENT_START}}}\\
von \textbf{{{EVENT_CLUB}}}\\
N° ACP du Club \textbf{{{EVENT_CLUB_NR}}}
};
\node[anchor=south,text width=6.6cm,font=\scriptsize,align=center] at (24.15,-7.0) {

63
event.yml.example Normal file
View File

@@ -0,0 +1,63 @@
# Event-Konfiguration für die Brevetkarte
# Vorderseite - Veranstaltungsinfo (Spalte 4)
event:
title: "Name der Veranstaltung"
km: "200"
date: "1. Januar 2025"
start_location: "Stadt, Ort"
club: "Clubname"
club_nr: "000000"
startzeit: "8:00"
# Rückseite - Zelleninhalt (3 Zeilen × 4 Spalten)
# LaTeX-Syntax: \\ für Zeilenumbruch, \textbf{...} für Fett
# Leere Zellen (für Stempel) einfach leer lassen: ""
backside:
"1_1": |
\vspace{2mm}
\textbf{Nr. 1:} Km 0 -- Unisport\\
Nachtigallenweg 86, Bonn\\
\\
\textbf{Kontrollzeit}\\
von: 7:30\\
bis: 8:30
"1_2": ""
"1_3": |
\vspace{2mm}
\textbf{Nr. 4:} Km 000 -- Kontrollname\\
Straße\\
\textbf{Kontrollzeit}\\
von: 00:00\\
bis: 00:00
"1_4": |
\vspace{2mm}
\textbf{Kontrollfrage:}\\
Fragetext
"2_1": |
\vspace{2mm}
\textbf{Nr. 2:} Km 000 -- Kontrollname\\
Adresse\\
\\
\textbf{Kontrollzeit}\\
von: 00:00\\
bis: 00:00
"2_2": ""
"2_3": |
\vspace{2mm}
\textbf{Nr. 5:} Km 000 -- Kontrollname\\
Adresse\\
\\
\textbf{Kontrollzeit}\\
von: 00:00\\
bis: 00:00
"2_4": ""
"3_1": |
\vspace{2mm}
\textbf{Nr. 3:} Km 000 -- Kontrollname\\
Adresse\\
\textbf{Kontrollzeit}\\
von: 00:00\\
bis: 00:00
"3_2": ""
"3_3": ""
"3_4": ""

View File

@@ -1,11 +1,18 @@
#!/usr/bin/env python3
"""
Generate personalized brevet cards from CSV data.
Generate personalized brevet cards from CSV and event config.
"""
import csv
import sys
from pathlib import Path
try:
import yaml
except ImportError:
print("Error: PyYAML not installed. Run: pip install pyyaml", file=sys.stderr)
sys.exit(1)
def escape_latex(text):
"""Escape special LaTeX characters."""
if not text:
@@ -27,8 +34,47 @@ def escape_latex(text):
result = result.replace(char, replacement)
return result
def load_event_config(config_file):
"""Load event configuration from YAML file."""
with open(config_file, 'r', encoding='utf-8') as f:
return yaml.safe_load(f)
def apply_event_placeholders(text, config):
"""Replace event-level placeholders in a template string."""
event = config.get('event', {})
replacements = {
'{{EVENT_TITLE}}': escape_latex(event.get('title', '')),
'{{EVENT_KM}}': escape_latex(event.get('km', '')),
'{{EVENT_DATE}}': escape_latex(event.get('date', '')),
'{{EVENT_START}}': escape_latex(event.get('start_location', '')),
'{{EVENT_CLUB}}': escape_latex(event.get('club', '')),
'{{EVENT_CLUB_NR}}': escape_latex(event.get('club_nr', '')),
'{{EVENT_STARTZEIT}}': escape_latex(event.get('startzeit', '')),
}
for placeholder, value in replacements.items():
text = text.replace(placeholder, value)
return text
def generate_backside(template, config):
"""Fill back side template with cell content from event config."""
cells = config.get('backside', {})
result = template
for row in range(1, 4):
for col in range(1, 5):
key = f"{row}_{col}"
placeholder = f"{{{{CELL_{row}_{col}}}}}"
content = cells.get(key, "")
if content is None:
content = ""
result = result.replace(placeholder, content.strip())
return result
def generate_card_from_template(template, data):
"""Replace placeholders in template with participant data."""
"""Replace participant placeholders in template with participant data."""
name = f"{escape_latex(data['Vorname'])} {escape_latex(data['Nachname'])}"
street = escape_latex(data['Straße'])
plz_ort = f"{escape_latex(data['PLZ'])} {escape_latex(data['Ort'])}"
@@ -36,7 +82,6 @@ def generate_card_from_template(template, data):
medaille = "Ja" if data['Medaille'].lower() == 'ja' else "Nein"
startnr = escape_latex(data['Startnr'])
# Replace placeholders
card = template.replace('{{NAME}}', name)
card = card.replace('{{STREET}}', street)
card = card.replace('{{PLZ_ORT}}', plz_ort)
@@ -46,30 +91,33 @@ def generate_card_from_template(template, data):
return card
def main():
csv_file = Path("Export Brevetkarte.csv")
template_file = Path("brevetkarte-template.tex")
backside_template_file = Path("brevetkarte-rueckseite-template.tex")
event_config_file = Path("event.yml")
output_file = Path("brevetkarte-personalized.tex")
backside_output_file = Path("brevetkarte-rueckseite.tex")
if not csv_file.exists():
print(f"Error: {csv_file} not found!", file=sys.stderr)
sys.exit(1)
for f in [csv_file, template_file, backside_template_file, event_config_file]:
if not f.exists():
print(f"Error: {f} not found!", file=sys.stderr)
sys.exit(1)
if not template_file.exists():
print(f"Error: {template_file} not found!", file=sys.stderr)
sys.exit(1)
print(f"Reading event config from {event_config_file}...")
event_config = load_event_config(event_config_file)
# Read template
print(f"Reading template from {template_file}...")
template = template_file.read_text(encoding='utf-8')
template = apply_event_placeholders(template, event_config)
# Read CSV data
print(f"Reading participant data from {csv_file}...")
participants = []
with open(csv_file, 'r', encoding='utf-8-sig') as f: # utf-8-sig handles BOM
with open(csv_file, 'r', encoding='utf-8-sig') as f:
reader = csv.DictReader(f)
for row in reader:
if row['Startnr']: # Skip empty rows
if row['Startnr']:
participants.append(row)
if not participants:
@@ -78,35 +126,34 @@ def main():
print(f"Found {len(participants)} participant(s)")
# Generate document with all cards
# Generate personalized front side
cards = []
for i, participant in enumerate(participants):
for participant in participants:
card = generate_card_from_template(template, participant)
cards.append(card)
# Combine cards with spacing/page breaks
document_parts = []
for i, card in enumerate(cards):
document_parts.append(card)
# Add vertical space between cards on same page
if i % 2 == 0 and i < len(cards) - 1:
document_parts.append("\n\\vspace{0.8cm}\n\n")
# Add page break after every 2 cards (except at the end)
if i % 2 == 1 and i < len(cards) - 1:
document_parts.append("\n\\newpage\n\n")
# Close document
document_parts.append("\n\\end{document}\n")
# Write output
document = ''.join(document_parts)
output_file.write_text(document, encoding='utf-8')
output_file.write_text(''.join(document_parts), encoding='utf-8')
print(f"Generated {output_file}")
# Generate personalized back side
print(f"Reading back side template from {backside_template_file}...")
backside_template = backside_template_file.read_text(encoding='utf-8')
backside_output = generate_backside(backside_template, event_config)
backside_output_file.write_text(backside_output, encoding='utf-8')
print(f"Generated {backside_output_file}")
print(f"Total pages: {(len(participants) + 1) // 2}")
print(f"Compile with: make build-personalized")
if __name__ == "__main__":
main()
main()