123 lines
3.0 KiB
Markdown
123 lines
3.0 KiB
Markdown
|
# 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
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 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 (participant info)
|
|||
|
|
- `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
|
|||
|
|
- `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
|