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 |
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 |
|---|---|
| Intérieur/extérieur mixte | INT/EXT. VOITURE - JOURI/E. MAISON - NUIT |
| 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.
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. - , – , — (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 | JOUR, MATIN, MIDI, APRÈS-MIDI, AUBE | DAY, MORNING, NOON, AFTERNOON, DAWN |
| Nuit | NUIT, SOIR, SOIRÉE, CRÉPUSCULE | NIGHT, EVENING, DUSK |
| Continu / autre | CONTINU, PLUS TARD | CONTINUOUS, LATER, SAME TIME |
Si votre format respecte la structure ci-dessus mais utilise un mot-clé temporel qui n'est pas dans cette liste, PreClap ne pourra pas détecter le moment de la journée. La séquence sera reconnue mais pas classifiée jour/nuit. Signalez-nous le mot-clé manquant à contact@preclap.com pour qu'on l'ajoute.
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.