Pourquoi votre PDF n'a peut-être pas été reconnu par PreClap, et comment y remédier.
PreClap analyse les scénarios formatés selon les standards de l'industrie audiovisuelle. Ces standards existent depuis des décennies et sont utilisés par tous les professionnels et tous les logiciels d'écriture du secteur. Si votre PDF n'a pas été reconnu, c'est presque toujours parce qu'il ne respecte pas l'une de ces conventions, et non parce que votre scénario est mauvais. Ce guide vous explique précisément ce que PreClap attend, et comment formater votre scénario pour qu'il soit lisible.
Ce guide est organisé en trois parcours selon votre profil. Choisissez celui qui vous correspond.
J'écris dans Word, Pages ou Google Docs. C'est mon premier scénario, je veux comprendre le format.
Trelby, Celtx, Highland, WriterDuet : j'ai un PDF mais quelque chose ne marche pas comme prévu.
Final Draft, Fade In, Fountain. Je veux la spécification exacte de ce que PreClap reconnaît.
Word, Pages et Google Docs sont des traitements de texte universels. Ils ne savent pas qu'un scénario a un format particulier. Si vous écrivez votre scénario dans Word et que vous tapez vos en-têtes de séquence en gras et soulignés, le résultat sera joli à l'écran, mais ce ne sera pas du format scénario standard. PreClap ne pourra pas le reconnaître, parce qu'il ne reconnaît que le format utilisé par l'industrie depuis 80 ans.
La bonne nouvelle : ce format est simple, et une fois que vous le connaissez, vous pouvez l'utiliser dans n'importe quel outil, y compris Word.
Pour qu'une séquence soit reconnue par PreClap, son en-tête doit respecter trois règles :
INT. ou EXT., (2) le lieu, (3) le moment de la journée (jour ou nuit).Voici un exemple complet d'une séquence correctement formatée. Vous pouvez la copier-coller pour vous en servir comme modèle :
INT. CUISINE - JOUR
Marie entre dans la pièce. Elle pose son sac sur la table
et regarde Pierre, debout devant la fenêtre.
MARIE
Tu es là depuis longtemps ?
PIERRE
Plus longtemps que je ne le pensais.
EXT. JARDIN - NUIT
Le vent fait bouger les branches. Marie sort de la maison,
emmitouflée dans son manteau.
Trois choses à noter dans cet exemple : les sluglines (INT. CUISINE - JOUR et EXT. JARDIN - NUIT) sont en majuscules sur leur propre ligne, les noms des personnages (MARIE, PIERRE) sont aussi en majuscules au-dessus de leurs répliques, et la séparation entre INT. / lieu / moment se fait avec un point puis un tiret entouré d'espaces.
Plutôt que de gérer le format manuellement dans Word, la solution recommandée pour un débutant est d'utiliser un éditeur de scénario qui formate tout automatiquement. Vous écrivez normalement, l'éditeur place les éléments à la bonne position, et vous exportez en PDF. Plusieurs outils gratuits font ça très bien :
Ces outils ne sont pas affiliés à PreClap. Ils sont listés ici parce qu'ils produisent par défaut des PDF dans un format que PreClap reconnaît sans difficulté. Une fois votre scénario écrit dans l'un d'eux, exportez-le en PDF, chargez-le sur PreClap, et l'analyse fonctionnera.
Si malgré tout vous tenez à écrire dans Word ou Google Docs, c'est tout à fait possible : appliquez simplement les trois règles ci-dessus, exportez en PDF, et vérifiez le résultat sur PreClap. Si quelque chose ne marche pas, passez à la section suivante.
Si vous écrivez déjà dans un éditeur de scénario et que PreClap ne reconnaît pas votre PDF, il y a quelques causes possibles. Cette section les passe en revue dans l'ordre de fréquence.
PreClap lit le texte contenu dans un PDF. Si votre PDF est en réalité une image (une photo ou un scan d'un document papier), il n'y a aucun texte à lire, juste des pixels. PreClap détecte ce cas et affiche un avertissement spécifique, mais c'est utile de savoir le reconnaître à l'avance.
Test rapide : ouvrez votre PDF dans n'importe quel lecteur, essayez de sélectionner du texte avec la souris. Si le curseur se transforme en outil de sélection et que vous pouvez surligner les mots, votre PDF contient du texte. Si vous obtenez un cadre de sélection rectangulaire qui sélectionne une zone de l'image, votre PDF est une image. Il faudra alors utiliser un outil d'OCR pour en extraire le texte avant de pouvoir l'analyser.
Certains éditeurs proposent à l'export une option de protection (mot de passe, restriction de copie, restriction d'impression). Ces protections empêchent PreClap d'extraire le texte. Solution : réexportez votre PDF en désactivant toutes les options de protection. Vos données restent privées de toute façon, PreClap supprime votre fichier dès l'analyse terminée.
PreClap reconnaît les formats les plus courants de slugline en français et en anglais. Mais il existe des variantes que le parser ne sait pas encore traiter. Le tableau ci-dessous liste les formats reconnus à ce jour, et ceux qui ne le sont pas encore.
| Type de format | Exemple |
|---|---|
| Standard français | INT. CUISINE - JOUR |
| Standard anglais | INT. KITCHEN - DAY |
| Avec point final | EXT. PARC - NUIT. |
| Sans espace autour du tiret | INT. SALON-SOIRÉE |
| Avec numérotation en début | 12. INT. CUISINE - JOUR |
| Avec numérotation et espace | 12 INT. CUISINE - JOUR |
| Temps composés français | INT. SALON - SOIRÉEEXT. CHAMP - AUBEEXT. PLAGE - CRÉPUSCULE |
| Avec qualificatif entre parenthèses | INT. CUISINE - JOUR (FLASHBACK)INT. CHAMBRE - NUIT (CONTINU) |
| Format Celtx français | SÉQUENCE 1 / INT JOUR - CUISINE |
| Tirets typographiques (en/em dash) | INT. CUISINE – JOURINT. CUISINE — JOUR |
| Intérieur/extérieur mixte | INT/EXT. VOITURE - JOUREXT/INT. MAISON - NUITI/E. VOITURE - JOURE/I. MAISON - NUITCatégorie tierce dans les statistiques (compteur mixte distinct de INT et EXT) |
Certains formats ne sont pas encore supportés par le parser actuel. Si votre PDF utilise l'un d'entre eux, PreClap risque de ne pas détecter vos séquences. Nous priorisons l'ajout de ces formats au fur et à mesure des retours utilisateurs.
| Type de format | Exemple |
|---|---|
| Numéro répété en fin de ligne (shooting script) | 57 INT. CUISINE - NUIT 57 |
| Format français avec point comme séparateur | INT. CUISINE. JOUR |
| Marqueurs temporels seuls (sans INT./EXT.) | FLASHBACKMOMENTS LATER |
| Formats de courts métrages avec SEQ | SEQ 2 - EXT/NUIT - LIEU |
Si votre format n'apparaît dans aucun des deux tableaux, écrivez-nous à contact@preclap.com avec un exemple. Chaque retour nous aide à prioriser les ajouts au parser.
Certaines options d'export PDF (notamment dans les versions anciennes de Celtx, dans Scrivener sans préset Screenplay, ou dans certaines configurations de Final Draft) produisent des PDF dont le texte est extrait avec des caractères incorrects, des lettres collées les unes aux autres, ou des espaces manquants. PreClap a des correctifs pour les cas les plus courants, mais pas pour tous.
Bonne nouvelle : la classe de mojibake la plus fréquente (minuscules accentuées résiduelles dans les sluglines en majuscules, type INTéRIEUR VéHICULE DE POLICE au lieu de INTÉRIEUR VÉHICULE DE POLICE) est désormais corrigée automatiquement par PreClap. Ces décors s'affichent proprement dans l'interface sans intervention de votre part. Le test ci-dessous ne concerne plus que les cas plus graves : caractères dans le désordre, mots fusionnés, ou symboles exotiques.
Test rapide : ouvrez votre PDF, sélectionnez quelques sluglines avec la souris, copiez-les, collez-les dans un éditeur de texte simple (TextEdit, Notepad, ou même la zone de recherche d'un navigateur). Si le texte arrive correctement, PreClap pourra le lire. Si vous obtenez des caractères bizarres, des lettres dans le désordre ou des mots fusionnés, votre PDF a un problème d'encodage à la source. Réexportez-le avec une autre option d'export.
Cette section s'adresse aux scénaristes et professionnels qui utilisent un éditeur dédié et qui veulent comprendre exactement ce que PreClap attend en entrée, pour optimiser leurs exports ou diagnostiquer un problème spécifique.
PreClap effectue un parsing déterministe basé sur des règles strictes. Aucun traitement automatique du langage, aucune intelligence artificielle, aucune interprétation. Une slugline est reconnue si et seulement si elle correspond à un motif explicitement supporté par le parser. La même entrée produit toujours la même sortie, et chaque décision peut être tracée.
Pour être détectée comme slugline, une ligne doit contenir, dans l'ordre :
INT., EXT., INT, EXT, INTÉRIEUR, EXTÉRIEUR, INTERIEUR, EXTERIEUR (avec ou sans accent), INT/EXT, EXT/INT, I/E, E/I (cas mixtes) - , – , — (espace-tiret-espace, avec tiret simple, demi-cadratin ou cadratin)Le dernier élément d'une slugline doit être l'un des mots-clés suivants. PreClap les reconnaît en français et en anglais, et les classifie automatiquement en jour ou en nuit pour les statistiques.
| Catégorie | Français | Anglais |
|---|---|---|
| Jour (simple) | JOUR, MATIN, MIDI, APRÈS-MIDI, AUBE | DAY, MORNING, NOON, AFTERNOON, DAWN, SUNRISE |
| Jour (composé) | PETIT MATIN, LEVER DU JOUR, FIN DE JOURNÉE, FIN DE JOUR, FIN D'APRÈS-MIDI | EARLY MORNING, LATE AFTERNOON |
| Nuit (simple) | NUIT, SOIR, SOIRÉE, CRÉPUSCULE | NIGHT, EVENING, DUSK, SUNSET |
| Nuit (composé) | TOMBÉE DE LA NUIT, TOMBÉE DU JOUR, DÉBUT DE SOIRÉE | NIGHTFALL |
| Continu / autre | CONTINU, PLUS TARD, MÊME MOMENT, MÊME TEMPS | CONTINUOUS, LATER, SAME, SAME TIME, MOMENTS LATER |
En complément, PreClap reconnaît les ellipses temporelles du type UN MOIS PLUS TARD, DEUX JOURS APRÈS, TROIS ANS AVANT. Le pattern est : un cardinal (UN, DEUX, ..., DIX, QUELQUES) suivi d'une unité de temps (SECONDES, MINUTES, HEURES, JOURS, SEMAINES, MOIS, ANS, ANNÉES) puis PLUS TARD, APRÈS ou AVANT.
Si votre format respecte la structure de slugline mais utilise un mot-clé temporel qui n'est dans aucune des listes ci-dessus, PreClap ne pourra pas détecter le moment de la journée. La séquence sera reconnue et comptée, mais pas classifiée jour/nuit. Signalez-nous le mot-clé manquant à contact@preclap.com pour qu'on l'ajoute.
Au-delà des sluglines standard, PreClap détecte cinq types de scènes spéciales et les classe automatiquement dans un compteur dédié, séparé du compteur de scènes ordinaires. Chaque scène détectée porte un champ scene_type visible sous forme de pastille dans la liste des scènes, et les statistiques globales affichent une carte « scènes narratives » qui agrège les compteurs. Cette information est utile pour les script doctors, producteurs et analystes qui veulent comprendre la rythmique structurelle d'un scénario sans avoir à lire ligne à ligne.
| Type de scène | Syntaxes captées |
|---|---|
montage |
Mention MONTAGE ou MONTAGE SEQUENCE en suffixe de slugline, y compris en shooting script avec numéro de scène final.Exemple : 10 INT. COMMUNITY HALL. MONTAGE SEQUENCE 10
|
flashback |
Suffixe entre parenthèses ou crochets : INT. KITCHEN - DAY (FLASHBACK), INT. WILL'S BEDROOM - DAY [FLASHBACK].Préfixe inline (style Jordan Peele) : FLASHBACK - INT. SMALL APARTMENT. NIGHT.Notation FR ARA : 17.FB INT. SALLE DE BAIN - NUIT (suffixe .FB sur le numéro de scène).
|
intercut |
Suffixe INTERCUT entre parenthèses ou crochets dans la slugline.Exemple : INT. KITCHEN - DAY (INTERCUT)
|
dream, vision, fantasy |
Marqueurs DREAM SEQUENCE, VISION SEQUENCE, FANTASY en suffixe parenthèse, crochets, ou en tête de slugline pure.Par défaut, les trois marqueurs sont agrégés dans un seul compteur de scènes oniriques. |
series_of_shots |
Marqueurs SERIES OF SHOTS ou QUICK CUTS.Par défaut, agrégés dans le compteur montage (convention dominante en écriture de long-métrage).
|
Si une slugline contient plusieurs marqueurs à la fois (cas rare mais documenté, par exemple INT. KITCHEN - DAY (FLASHBACK / MONTAGE)), PreClap applique une cascade de priorité déterministe : flashback > intercut > montage > dream / vision / fantasy > series_of_shots > ordinary. L'exemple ci-dessus est donc classé flashback. Cette priorité reflète le fait que la temporalité narrative (flashback) prime sur la technique de montage, et que le montage prime sur la déclinaison plus spécifique « série de plans ».
La détection en V1 fonctionne uniquement sur la slugline elle-même. Les marqueurs paratextuels portés par des lignes séparées ne sont pas encore captés : BEGIN FLASHBACK: / END FLASHBACK sur leurs propres lignes, INTERCUT WITH: annonçant une coupure de scène, FLASHBACK POUR : / FIN DE FLASHBACK (notation FR). Si votre scénario utilise ces conventions, les scènes concernées seront comptées comme ordinary. Le support de ces marqueurs est prévu dans une version future.
Les notations FR atypiques de type (FLASH BACK EN ELLIPSE) ou (INSERT FLASH BACK) ne sont pas non plus reconnues à ce jour. Si vous utilisez l'une de ces variantes, signalez-le-nous à contact@preclap.com avec un exemple.
Voici les options d'export PDF qui produisent les meilleurs résultats avec PreClap pour les éditeurs les plus courants :
| Éditeur | Méthode d'export recommandée |
|---|---|
| Final Draft | File → Save as PDF, en cochant l'option Embed standard fonts. Évitez l'option Production Document qui ajoute des numéros de scène en marge et perturbe le parsing. |
| Fade In | File → Print → Save as PDF. Choisissez l'export standard et non l'export Print Production Document. |
| Highland 2 | File → Export → PDF. N'activez pas le mode Pretty Mode qui modifie la mise en page. |
| WriterDuet | Export → PDF, version Standard (pas Production). |
| Trelby | File → Export → PDF. Format par défaut compatible. |
| Celtx | Selon votre version. Le format Celtx français au sens SÉQUENCE N / INT JOUR - LIEU est explicitement supporté depuis avril 2026. |
| KIT Scenarist | Export → PDF. Format par défaut compatible. |
| Scrivener | Compile → PDF, en utilisant impérativement un préset Screenplay. Sans ce préset, Scrivener exporte le texte brut sans la mise en forme scénario. |
L'import direct de fichiers .fountain est prévu pour une version future. En attendant, vous pouvez exporter votre fichier Fountain en PDF via Highland, Slugline ou WriterDuet, puis charger ce PDF dans PreClap.
Si l'analyse de votre scénario donne un résultat inattendu, ce tableau peut vous aider à identifier la cause.
| Ce que vous observez | Cause probable | Solution |
|---|---|---|
| Aucune séquence détectée | Sluglines absentes, non standard, ou PDF scanné | Vérifiez la section débutant ou intermédiaire ci-dessus selon votre cas |
| Beaucoup moins de séquences que prévu | Certaines sluglines utilisent un format non encore reconnu | Comparez votre format aux deux tableaux de la section intermédiaire. Si votre format n'y figure pas, signalez-le-nous |
| Personnages manquants ou mal détectés | Les noms de personnages ne sont pas en majuscules, ou ne sont pas centrés sur leur propre ligne | Vérifiez que chaque nom de personnage est en MAJUSCULES, sur sa propre ligne, juste au-dessus de la réplique |
| Décors fusionnés ou divisés bizarrement | Variations d'orthographe entre vos sluglines : CUISINE, CUISINE - SUITE, LA CUISINE |
C'est normal. PreClap distingue ces variantes intentionnellement. L'audit homonymes (offre Premium) signale ces cas pour validation manuelle |
| Caractères bizarres dans le résultat | L'export PDF a cassé l'encodage à la source | Réexportez votre PDF depuis l'original avec une autre option d'export. Voir cause 4 de la section intermédiaire |
| Le moment de la journée n'est pas détecté | Mot-clé temporel non reconnu ou absent de la slugline | Voir la liste exhaustive des mots-clés temporels dans la section professionnelle |
Écrivez-nous à contact@preclap.com. Joignez votre PDF si vous le pouvez (il restera confidentiel et ne sera pas conservé après diagnostic). Chaque cas exotique que nous documentons devient une amélioration future du parser et du guide.