From fbd55f841aa2c96d2a90e0d53556780272278670 Mon Sep 17 00:00:00 2001
From: Peter Adam <p.adam@cygnusnetworks.de>
Date: Sat, 28 Feb 2026 10:15:07 +0100
Subject: [PATCH] Update README: document CSV workflow and file list

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index e21d14b..4f5e446 100644
--- a/README.md
+++ b/README.md
@@ -43,6 +43,20 @@ make build-back
 make build-pdf
 ```
 
+### Personalized Cards from CSV
+
+```bash
+# 1. Copy the example CSV and fill in participant data
+cp "Export Brevetkarte.csv.example" "Export Brevetkarte.csv"
+# Edit "Export Brevetkarte.csv" with your participants
+
+# 2. Generate and build personalized cards
+make build-personalized
+# Output: brevetkarte-personalized.pdf
+```
+
+The CSV file `Export Brevetkarte.csv` is not tracked by git (it may contain personal data). The file `Export Brevetkarte.csv.example` shows the expected format.
+
 ### Other Commands
 
 ```bash
@@ -67,10 +81,13 @@ make help
 
 ## Files
 
-- `brevetkarte.tex` - LaTeX source for the front side (participant info)
+- `brevetkarte.tex` - LaTeX source for the front side (two identical blank cards)
+- `brevetkarte-template.tex` - Template for personalized cards (placeholders replaced from CSV)
 - `brevetkarte-rueckseite.tex` - LaTeX source for the back side (control points)
-- `cyclist-logo.png` - Audax Randonneurs logo (extracted from original)
-- `Dockerfile` - Docker image definition with TeXLive
+- `Export Brevetkarte.csv.example` - Example CSV with participant data format
+- `generate_cards.py` - Generates `brevetkarte-personalized.tex` from CSV and template
+- `cyclist-logo.png` - Audax Randonneurs logo
+- `Dockerfile` - Docker image definition (debian:bookworm-slim + TeX Live packages)
 - `Makefile` - Build automation
 
 ## Output