CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Guide Turf is a Quarto-based documentation website about French horse racing (courses hippiques) and mutual betting (paris mutuels). The site can be rendered as a website or as a PDF/ePub book.

Commands

# Install dependencies
uv sync

# Preview site with live reload (serves at localhost:4000)
uv run quarto preview

# Render website to _site/
uv run quarto render

# Render PDF/ePub book to _book/
uv run quarto render --profile book

# Check Quarto installation and project
uv run quarto check

# Generate SEO assets (sitemap.xml, llms-full.txt)
uv run python scripts/generate-seo.py

Architecture

Configuration Files

• _quarto.yml - Main website configuration (default profile)
• _quarto-book.yml - Book format configuration (PDF/ePub), activated with --profile book
• pyproject.toml - Python dependencies managed with uv

Content Structure

All content is in .qmd (Quarto Markdown) files:

guides/
├── fondamentaux/     # Betting basics and fundamentals
├── monde-hippique/   # Horse racing world (horses, races, tracks, people)
│   ├── chevaux/      # Horse breeds and characteristics
│   ├── courses/      # Race types (galop, trot, obstacle)
│   ├── hippodromes/  # Racetracks and terrain
│   └── acteurs/      # Jockeys, trainers, owners
├── paris-mutuels/    # Betting operators and bet types
│   ├── pmu/          # PMU bets (Simple, Tiercé, Quarté+, Quinté+, etc.)
│   ├── genybet/      # Genybet bets (Solo, Duo, Trio, Quatro)
│   ├── zeturf/       # Zeturf bets (Ze4, Ze5, Ze234, etc.)
│   └── leturf/       # Le Turf bets (Top4, Top5, Tic3, Tertio)
├── techniques/       # Betting strategies (champ total, bankroll, etc.)
└── lexique/          # A-Z glossary of horse racing terms

Theming

• assets/theme.scss - Custom SCSS theme (primary: green #1a5f2c)
• assets/styles.css - Font styles

Output Directories

• _site/ - Rendered website (gitignored)
• _book/ - Rendered PDF/ePub (gitignored)
• _freeze/ - Quarto execution cache

Content Guidelines

QMD Frontmatter

Every .qmd file should have YAML frontmatter:

---
title: "Page Title"
subtitle: "Optional subtitle"
description: "SEO description"
categories: [catégorie1, catégorie2]
---

Language

All content is in French. The site uses French Quarto language settings configured in _quarto.yml.

Navigation

The sidebar navigation is defined in _quarto.yml under website.sidebar. Content is auto-discovered using glob patterns like guides/paris-mutuels/pmu/*.qmd.

CI/CD

GitHub Actions workflow (.github/workflows/build.yml) automatically: 1. Renders the site with Quarto 2. Deploys to GitHub Pages on pushes to main