# Documentation Technique sur le Format Attendu des Fichiers VTT pour la Méthode vttFileParser

## Introduction
Cette documentation s'adresse aux rédacteurs de fichiers VTT (WebVTT) qui doivent suivre un format standard pour être correctement analysés par la méthode `vttFileParser`. Elle explique le format attendu des fichiers VTT, notamment en ce qui concerne les références de présentation, les timecodes et les titres de présentation.

## Format des Fichiers VTT

### Structure Générale
Les fichiers VTT doivent suivre une structure spécifique pour permettre à la méthode `vttFileParser` de correctement extraire les informations nécessaires. Voici les éléments clés de cette structure :

1. **Déclaration de Fichier**
   - Le fichier commence par la déclaration `WEBVTT`.

2. **Références de Présentation**
   - Les références de présentation doivent suivre le pattern `PRES_XXXXX`.
   - Les lignes contenant ces références doivent commencer par "PRES".
   - Exemple : `PRES_6`, `PRES_7`.

3. **Timecodes**
   - Les timecodes doivent être au format `hh:mm:ss.mmm --> hh:mm:ss.mmm` ou `hh:mm:ss:mmm --> hh:mm:ss:mmm`.
   - Cela permet une flexibilité dans l'utilisation des points (`.`) ou des deux-points (`:`) pour séparer les millisecondes.
   - Exemple : `00:00:46.000 --> 00:26:55.000` ou `00:00:46:000 --> 00:26:55:000`.

4. **Titres de Présentation**
   - Les titres des présentations doivent être inclus dans les lignes contenant le mot "Presentation" ou "presentation".
   - Exemple : `$Presentation Exercise outcomes`.

### Exemple de Fichier VTT
Voici un exemple valide d'un fichier VTT conforme aux attentes :

```
WEBVTT

SESSION_3
00:00:00.000 --> 12:00:00.000
$Session Session title does not matter

PRES_6
00:00:46:000 --> 00:26:55.000
$Presentation Exercise outcomes

PRES_7
00:26:55.000 --> 01:01:53.000
$Presentation Digital mobility outcomes

PRES_8
01:01:53.000 --> 01:15:26.000
$Presentation Discussion and Q&A
```

### Détails Techniques

#### Références de Présentation
- **Pattern** : `/^PRES/`
  - Ce pattern vérifie que les lignes commencent par "PRES".
- **Pattern pour extraction** : `/(?:PRES_)?([A-Za-z0-9]+(?:-[A-Za-z0-9]+)*)/`
  - Ce pattern extrait la partie significative de la référence après "PRES_".

#### Timecodes
- Les timecodes doivent être spécifiés au format `hh:mm:ss.mmm --> hh:mm:ss.mmm` ou `hh:mm:ss:mmm --> hh:mm:ss:mmm` pour plus de flexibilité.

#### Titres de Présentation
- Les titres de présentation doivent être inclus dans une ligne contenant "Presentation" ou "presentation".

## Conclusion
En suivant ces directives, vous pouvez rédiger des fichiers VTT compatibles avec la méthode `vttFileParser`. Assurez-vous que les références de présentation commencent par "PRES", utilisez les formats flexibles pour les timecodes, et incluez les titres de présentation de manière claire. Cette standardisation garantit une extraction précise et efficace des informations nécessaires.