brevetcard/README.md

# Brevet Card PDF Generator

LaTeX-based generator for Audax Randonneurs Deutschland brevet cards with front and back sides for duplex printing.

## Quick Start

```bash
# Build everything and generate both PDFs
make build

# The PDFs will be created as:
# - brevetkarte.pdf (front side with participant info)
# - brevetkarte-rueckseite.pdf (back side with control points)
```

## Prerequisites

- Docker
- Make

## Usage

### Build Both PDFs
```bash
make build
```

This will:
1. Build the Docker image with TeXLive
2. Compile `brevetkarte.tex` to `brevetkarte.pdf` (front side)
3. Compile `brevetkarte-rueckseite.tex` to `brevetkarte-rueckseite.pdf` (back side)

### Build Individual Sides

```bash
# Just build front side
make build-front

# Just build back side
make build-back

# Build both sides (without rebuilding Docker image)
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
# Just build the Docker image
make build-image

# Open interactive shell in container
make shell

# Clean generated files (.aux, .log, .pdf)
make clean

# Clean everything including Docker image
make clean-all

# Rebuild from scratch
make rebuild

# Show help
make help
```

## Files

- `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)
- `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

### Front Side (brevetkarte.pdf)
Contains two identical brevet cards that can be cut in half. Each card includes:
- Participant information fields (Name, Address, etc.)
- Event details (200km "Auf eine Pommes nach Belgien")
- Randonneur Mondiaux rules
- Homologation section
- Start time: 8:30

### Back Side (brevetkarte-rueckseite.pdf)
Contains control points table (4 columns × 6 rows):
- **Rows 1-3**: Control points for upper card
  - 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 - Finish (Unisport, Bonn)
- **Rows 4-6**: Control points for lower card (same as above, but Nr. 5: Km 214)
- Empty columns for stamps/signatures
- Control question for verification

## Duplex Printing

The PDFs are designed for duplex (double-sided) printing:
1. Print `brevetkarte.pdf` on one side
2. Print `brevetkarte-rueckseite.pdf` on the reverse side
3. The columns and rows are aligned so that:
   - Front side columns match back side columns
   - Upper card (rows 1-3) aligns with front side upper card
   - Lower card (rows 4-6) aligns with front side lower card
4. Cut the sheet in half horizontally to create two separate brevet cards

## Customization

Edit `brevetkarte.tex` to modify front side:
- Event name, date, and location
- Distance (200km)
- Start time
- Club information
- Brevet number format

Edit `brevetkarte-rueckseite.tex` to modify back side:
- Control point locations
- Control times (von/bis)
- Distances
- Control questions