# Générateur d'étiquettes — Guide utilisateur

Cette extension imprime des **étiquettes** à partir de votre concours Equipe, sous forme de PDF mis en page pour correspondre à votre planche d'étiquettes — par exemple la **planche Bruneau 70 × 35 mm, 24 étiquettes par page A4**.

Elle existe en **deux versions**, avec le même écran et les mêmes paramètres ; seul le contenu des étiquettes diffère :

| Version | Chaque étiquette affiche | Quelles étiquettes sont imprimées |
|---|---|---|
| **Étiquettes participants** | Numéro et nom du cheval, nation et nom du cavalier, votre logo, numéro de club et un texte libre | Les compétitions que vous choisissez |
| **Étiquettes compétitions** | Date, numéro de compétition, épreuve/type, carrière | Automatiquement : chaque compétition CSI de la semaine en cours |

Ouvrez l'extension depuis le concours dans Equipe : il n'y a aucune connexion à effectuer.

---

## 1. Choisir les compétitions *(étiquettes participants)*

Sélectionnez une compétition dans **Select Competition** : elle est déplacée vers **Selected Competitions**. Répétez l'opération pour en ajouter d'autres ; l'icône de la corbeille rouge permet d'en supprimer une.

La version pour étiquettes de compétition ignore cette étape.

## 2. Ajouter un logo *(étiquettes participants)*

Téléchargez une image **JPEG ou PNG**. Elle est imprimée en bas à gauche de chaque étiquette. Sans logo, le texte utilise toute la largeur.

## 3. Choisir la planche d'étiquettes

Choisissez votre planche dans les **presets** en haut de la section des dimensions. Pour la planche Bruneau, choisissez :

> **Bruneau 70 × 35 mm — 24 par feuille A4 (réf. 171-37)**

Toutes les dimensions sont remplies d'un coup. Les formats Avery sont également disponibles dans la version étiquettes de compétition.

### Autres planches

Si votre planche ne figure pas dans la liste, saisissez ses mesures (les décimales sont autorisées, ex: `8.5`) :

| Champ | Signification |
|---|---|
| **Rows / Columns** | Nombre d'étiquettes en lignes et en colonnes sur une page |
| **Label width / height** | Taille d'une étiquette (mm) |
| **Column / row gutter** | Espace **entre** les étiquettes (0 si elles se touchent) |
| **Page margins** | Marge blanche autour des étiquettes (mm) |

Mesurez avec précision : une marge arrondie de 8,5 à 8 mm suffit à décaler les étiquettes du bas.

## 4. Options *(étiquettes participants)*

- **Custom Text** — texte imprimé au bas de chaque étiquette.
- **Sort by** — numéro du cheval, nom de famille du cavalier ou prénom du cavalier.
- **Print only horses not present before** — exclut les chevaux marqués *Already on place* (voir l'extension **Already On Site — Vet Check**).

## 5. Imprimer

Cliquez sur **Generate and Print Labels**. Le PDF s'ouvre dans une nouvelle fenêtre et la boîte de dialogue d'impression apparaît.

Dans la boîte de dialogue d'impression — **ceci est essentiel** :

1. **Échelle** : **Taille réelle / 100%**. Ne choisissez jamais *Ajuster à la page* ou *Réduire pour ajuster* : les étiquettes se décaleraient vers le bas de la page.
2. **Marges** : **Aucune**.
3. Si rien ne s'ouvre, **autorisez les fenêtres surgissantes (pop-ups)** pour le site.

**Première fois :** imprimez une page sur du papier ordinaire, tenez-la contre une planche d'étiquettes devant une fenêtre et vérifiez l'alignement.

## 6. Ajuster pour votre imprimante *(si nécessaire)*

Chaque imprimante présente un léger décalage. Si toute l'impression est décalée uniformément, corrigez-le avec :

- **Offset X** — une valeur positive déplace tout vers la **droite**, une valeur négative vers la **gauche** ;
- **Offset Y** — une valeur positive déplace tout vers le **bas**, une valeur négative vers le **haut**.

Ajustez par paliers de **0,5 mm**. Une fois réglées, les valeurs restent valides pour cette imprimante.

---

## Référence rapide — Bruneau 70 × 35 mm

| Paramètre | Valeur |
|---|---|
| Rows / columns | 8 / 3 |
| Label | 70 × 35 mm |
| Gutters | 0 / 0 mm |
| Margins | gauche 0 · droite 0 · haut 8.5 · bas 8.5 mm |
| Offset | X 0 · Y 0 (à ajuster par imprimante) |
| Impression | Taille réelle / 100%, marges Aucune |

---

## FAQ

**Les étiquettes dérivent de plus en plus vers le bas de la page.**
Le PDF a été imprimé avec l'option *Ajuster à la page*. Imprimez à nouveau en **Taille réelle / 100%**.

**Tout est décalé de la même quantité dans une direction.**
Décalage de l'imprimante : corrigez-le avec **Offset X / Y**.

**Les noms longs de chevaux ou de cavaliers sont coupés.**
Le texte est réduit automatiquement pour s'adapter. Si c'est encore trop serré, utilisez une étiquette plus large ou un texte personnalisé plus court.

**Le texte touche le logo.**
Utilisez une étiquette plus haute.

**Aucun PDF n'apparaît.**
Autorisez les fenêtres surgissantes pour le site et réessayez.

**Un nom affiche des caractères incorrects (é, ç…).**
Signalez le nom concerné : la plupart des cas sont corrigés automatiquement.

**Une étiquette est manquante ou vide.**
L'entrée manque d'informations (cheval, cavalier...) dans Equipe et est ignorée. Complétez l'information dans Equipe et imprimez à nouveau.