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