Update README: document CSV workflow and file list

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Peter Adam
2026-02-28 10:15:07 +01:00
parent dbc3dc18ac
commit fbd55f841a

View File

@@ -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