Manuel d'utilisation Presswork (FR)

Ce manuel décrit toutes les fonctionnalités de Presswork, avec un parcours guidé pour chaque zone de l'application.

1. Vue d'ensemble

Presswork est un éditeur Markdown professionnel pour l'édition et l'autoédition. Il combine une écriture épurée, des outils éditoriaux (style, synopsis, versions) et des exports professionnels (PDF, PDF/X, EPUB, DOCX, HTML, ICML, FDX). Il inclut Typst pour des PDF rapides et prend en charge LaTeX + Ghostscript pour les PDF/X certifiés.

2. Prérequis et installation

Inclus : Pandoc, Typst (PDF Base), moteurs internes.
Optionnels (Pro) : LaTeX et Ghostscript pour les PDF/X certifiés.

Où vérifier :

Outils → Contrôle export : vérification et guide d'installation.

3. Modes et licences (Base / Pro)

Base : interface simplifiée, PDF rapide avec Typst, moins d'options.
Pro : PDF/X, préflight, multi-export, options avancées et outils éditoriaux complets.
Basculez à la volée avec l'interrupteur Base/Pro de l'en-tête ; le plan complet et la Licence se gèrent via Paramètres → App → Vue de travail.

4. Interface principale

En-tête : accès rapide à Document, Outils, Export, Vue, licence, manuel.
Éditeur : zone Markdown avec barre d'outils et raccourcis.
Barre latérale : Outline, Snapshot, Backlink, Scrivener.
Barre d'état : mots, caractères, ligne/colonne, objectifs.

5. Menu Documents

Nouveau : crée un nouveau document.
Enregistrer MD / Enregistrer sous… : enregistre en .md.
Importer un document : Word (.docx, .doc), ODT, HTML, Markdown, PDF, ICML, Final Draft. Les images arrivent avec le texte : les figures d'un document Word — y compris les tableaux Excel collés en image — et celles incorporées dans un PDF sont extraites dans un dossier à côté du fichier importé. Ce qui est dessin vectoriel dans un PDF (beaucoup de graphiques le sont) n'est pas une image et ne peut pas être extrait.
Ouvrir un projet : charge un projet par chapitres.
Mode Structure : gestion des chapitres/de l'ordre.
Gérer le projet : crée/met à jour les projets éditoriaux.
Imprimer : imprime le document courant.
Versions : historique des sauvegardes automatiques et restauration.

Flux conseillé :

Créez un document ou un projet.
Enregistrez souvent.
Utilisez Versions pour récupérer des révisions.

6. Menu Outils

Objectifs : cibles de mots quotidiennes ou par document.
Statistiques : évolution de l'écriture, rythme, difficulté, flow.
Guide utilisateur : manuel intégré.
Contrôle export : vérifie LaTeX/Ghostscript.
Command Palette : recherche de commandes (Ctrl/Cmd + P).
Analyse de style : répétitions, lisibilité, ton, inclusivité.
Assistant IA : résumés, réécritures, cohérence.
Mode Vim : commandes Vim.
Collab : sessions collaboratives P2P avec invitation rapide par ID de session.
- Démarrage rapide : ouvrez Outils → Collab, saisissez votre nom, créez ou collez un ID de session (pw-...) et appuyez sur Connecter.
- En appel : utilisez les boutons micro et caméra du panneau flottant ; si WebRTC échoue, configurez le relais WebSocket (presswork-collab-relay-url).
Tour : parcours guidé des formats spéciaux.
Signature numérique : signe les PDF avec un certificat (Pro).

7. Menu Export

Formats principaux

PDF (Typst, rapide)
PDF/X (LaTeX, certifié)
PDF Scénario (Hollywood)
FDX (Final Draft)
DOCX / ODT
EPUB
HTML
ICML (InCopy/InDesign)

Options

Style PDF : sélection du modèle PDF.
PDF/X : profil ICC, validation, polices incorporées.
Traits de coupe/Fond perdu : options d'impression.
Métadonnées EPUB + Couverture.
Préflight : liste de contrôle qualité et impression.
Historique des exports : journal des exportations.
Export multiple : plusieurs fichiers en un.
Export multi-format : PDF + EPUB + HTML, etc.
Exporter avec ressources : inclut images/ressources.
Convertir un dossier : conversion par lots.

8. Menu Vue

Modes : Écriture, Code, Aperçu, Page, Split.
Langue : 9 langues d'interface.
Thème : Clair/Sombre.
Machine à écrire : ligne active centrée.
Mode Focus : masque l'interface (F11).
Présentation : diapositives plein écran.
Accessibilité : taille du texte, contraste, police dyslexie.

9. Barre d'outils de l'éditeur

Mise en forme : gras, italique, souligné.
Titres : H1/H2/H3.
Éléments : liens, images, code en ligne/bloc.
Listes : à puces/numérotées.
Citations.
Tableaux.
CriticMarkup : insertion, suppression, commentaire.
Modèles : préréglages de mise en page.
Métadonnées : front matter YAML.
Snapshot : instantanés de scène.
Synopsis : résumés par chapitre.

10. Panneaux latéraux

Outline : navigation par sections.
Snapshot : gestion des instantanés.
Backlink : liens entre documents.
Scrivener : chapitres et glisser-déposer.
Scene Navigator : pour les scénarios.

11. Écrire en Markdown

Syntaxe de base

# Titre / ## Sous-titre
**gras**, *italique*
- liste / 1. liste numérotée
[lien](url)
![alt](image)
> citation
\newpage pour un saut de page

Conseils

Glissez-déposez les images.
Utilisez Split ou Aperçu pour contrôler la mise en page.

12. Modèles

Modèles prédéfinis : accès depuis la barre d'outils (Tpl).
Modèles personnalisés :
- Import d'un fichier unique ou d'un dossier (menu Modèles → « Importer un fichier / Importer un dossier »).
- Classement automatique par onglets : css→UI Kit, xlsx/xls/ods/csv→Business, autres→Documents.
- Badge Custom et infobulle complète au survol (nom + description).
- .md : chargeables dans l'éditeur.
- .tex/.pdfx/.pdft : utilisables comme styles d'export PDF.
- .xlsx/.xls/.ods/.csv : utilisables dans les flux tableur/rapport.
Auto-appariement UI↔PDF : les thèmes CSS peuvent s'apparier automatiquement au modèle PDF (interrupteur + Désapparier).
Bibliothèque partagée : enregistre des préréglages typographiques partagés.
Référence complète des fonctions de modèles : docs/template-functions-overview-en.md.

13. Métadonnées et front matter

Éditeur de métadonnées pour titre, auteur, ISBN.
Front matter YAML pour des exports cohérents.
EPUB : couverture et métadonnées fortement recommandées.

14. Projets et Mode Structure

Documents → Gérer le projet.
Créez le dossier du projet.
Ajoutez des chapitres (.md).
Réordonnez par glisser-déposer.
Exportez le tout avec ordre automatique.

15. Exports en détail

15.1 PDF Base (Typst)

Rapide, sans LaTeX.
Idéal pour brouillons et relectures.

15.2 PDF/X (LaTeX)

Utilise un modèle certifié.
Requiert LaTeX + Ghostscript.
Prend en charge ICC, validation et préflight.

15.3 PDF Scénario

Mise en page Hollywood.
Compatible Fountain.

15.4 FDX (Final Draft)

Export pour les flux cinématographiques, avec un rapport .breakdown.json à côté (scènes, personnages, tags).
Dialogue simultané : ajoutez ^ après le nom du second personnage (GUIDO^) — dans Final Draft les répliques s'affichent côte à côte (dual dialogue natif) ; à l'import d'un .fdx le ^ réapparaît tout seul.
Tags de production : clic droit sur un mot sélectionné → Taguer pour la production, ou écrivez [[prop: torche]] ou #prop: torche en fin de ligne. Dans le FDX ils deviennent des tags natifs du Tagger ; dans les autres formats les marqueurs sont retirés ; les tags posés dans Final Draft reviennent à l'import.
Clés principales (italien ou anglais) : prop, costume, vehicle, sound, music, makeup, animal, effects, location, note.
Le titre et l'auteur (front matter, ou # Titre + « by … » en tête) vont dans la Title Page de Final Draft.

15.5 DOCX/ODT

Conversion via Pandoc.

15.6 EPUB

Métadonnées + couverture recommandées.
Compatible avec les librairies numériques.

15.7 HTML

Sortie web avec ressources.

15.8 ICML

Styles mappés pour InDesign/InCopy.
Titres, listes, citations et scénario convertis en styles dédiés.
Préréglages de modèles inclus + import d'un .icml personnalisé.
Vraies notes de bas de page (numérotées par InDesign), liens avec destinations, tableaux avec en-têtes et alignements, images en blocs liés (panneau Liens), exposants/indices et petites capitales — y compris dans les cellules, notes et liens.
Réimport fidèle : un ICML exporté puis rouvert dans PressWork préserve le document (aller-retour vérifié en CI, même sur les manuscrits longs).

15.9 Excel

Export Excel avec dépouillement des scènes, personnages et production.
Prise en charge des modèles : écrit dans les feuilles existantes pour conserver les styles de base.
Import multi-feuilles vers des tableaux Markdown (avec métadonnées type/cellule).
Sélection de feuille et de plage à l'import pour éviter les données indésirables.
Chart Mapper : optionnel, génère des graphiques d'aperçu à partir des données Excel.

16. Export avancé

Export multiple : fusionne plusieurs documents.
Export multi-format : génère PDF+EPUB+HTML dans un dossier.
Exporter avec ressources : copie images et ressources.
Historique des exports : journal et résultats.

17. KDP (Amazon)

Quick Export : PDF + EPUB avec nommage KDP.
Calculateur : dimensions et marges.
Modèles KDP : couvertures/mises en page dédiées.
Validateur ePub : liste de contrôle, aperçu Kindle et rapport téléchargeable.

18. Analyse de style

Phrases longues, répétitions, voix passive.
Suggestions en ligne.
Métriques de lisibilité.

19. Assistant IA

Résumés, réécriture, cohérence, titres.
Services cloud déjà prêts dans le menu : OpenAI, Anthropic (Claude), Mistral et les agrégateurs comme OpenRouter. En choisir un règle l'adresse et le modèle : il ne reste qu'à coller la clé.
Chaque service retient sa clé : passer de l'un à l'autre ne demande plus de la ressaisir. Les clés sont dans le trousseau du système, pas dans un fichier de l'application.
Modèles locaux : « Détecter Ollama » affiche ceux installés sur votre ordinateur. Aucune clé n'est nécessaire et rien ne quitte la machine.
Test de connexion vérifie le canal réellement utilisé — le cloud si vous avez une clé, le local sinon — et indique lequel il a vérifié.

20. Collaboration (P2P)

Sessions partagées avec curseurs distants colorés, commentaires en ligne et synchronisation en direct.
Appels voix/vidéo intégrés pendant la session.
ID de session partageable (pw-...) pour inviter rapidement d'autres utilisateurs.

Comment l'utiliser (pas à pas)

Ouvrez Outils → Collab et choisissez un nom reconnaissable.
Créez une nouvelle session ou collez l'ID reçu d'un collègue.
Attendez le statut Online et vérifiez les participants dans le dock de collaboration.
Pour la voix/vidéo, lancez l'appel depuis le panneau Collab et utilisez les boutons muet/caméra.
Sur les réseaux d'entreprise restrictifs, configurez le relais WebSocket (clé localStorage : presswork-collab-relay-url).

21. Signature numérique

Signature de PDF avec certificat PAdES-T.
Horodatage RFC 3161 (réseau requis).

22. Présentation

Transforme les documents en diapositives.
Mises en page et palettes configurables.

23. Accessibilité

Taille du texte 12–18px.
Contraste élevé.
Police adaptée à la dyslexie.

24. Raccourcis principaux

Ctrl/Cmd + S → Enregistrer
Ctrl/Cmd + N → Nouveau
Ctrl/Cmd + P → Command Palette
Ctrl/Cmd + Shift + P → Présentation
F11 → Mode Focus
Ctrl/Cmd + B/I/U → Gras/Italique/Souligné
Ctrl + Alt + V → Vim

25. Dépannage

PDF/X indisponible : installez LaTeX + Ghostscript et redémarrez.
Modèles invisibles : utilisez « Ouvrir le dossier des modèles » et vérifiez les extensions.
Export lent : désactivez la validation en phase de brouillon.

26. Chemins utiles

Modèles personnalisés : dossier presswork/templates dans le répertoire de configuration utilisateur.
PDF/X ICC : dossier presswork/pdfx.

Presswork allie simplicité et outils éditoriaux professionnels : écrivez vite en Base, publiez en Pro.

Mises à jour récentes (Data Hub / Graphiques)

L'insertion d'un graphique depuis l'Excel Data Hub affiche désormais immédiatement un aperçu image dans l'éditeur aussi, pas seulement dans le panneau d'aperçu.
L'aperçu en ligne a été réduit (environ 50 %) pour être moins envahissant pendant l'écriture.
Bascule bidirectionnelle : 📝 Afficher le code ouvre le bloc chart-data, 🖼️ Retour au graphique restaure la vue image.
Le bloc chart-data reste dans le Markdown pour garantir la compatibilité avec aperçu/rendu/export.
Insérer un tableau ou un graphique en tant qu'image enregistre désormais le fichier dans les ressources du document (nomdoc.assets/images/) et seul le lien Markdown entre dans l'éditeur : cela fonctionne même avec des feuilles très volumineuses.
Si le document n'est pas encore enregistré, l'application propose de l'enregistrer immédiatement (comme pour le glisser-déposer d'images) ; en cas de refus, le tableau entre en texte Markdown et le graphique reste dans la feuille.
La question texte/image comprend aussi des réponses comme « png », « jpg », « image », « photo » ; une réponse non reconnue fait répéter la question.
La grille de données suit le thème clair/sombre actif.
Enregistrer comme modèle : fenêtre repensée dans le style de l'application et traduite. Requiert des données dans la grille et un modèle dans l'éditeur avec des espaces réservés {{NomColonne}} ; « Générer Markdown » répète le modèle pour chaque ligne.
Export Excel (dépouillement) : lit le texte de l'éditeur (scènes INT./EXT. ou chapitres #) ; s'il ne trouve pas de scènes, il avertit désormais au lieu de générer un fichier vide.
Menu Tables simplifié : suppression de l'entrée en double « Importer comme modèle » (identique à « Ouvrir la feuille Tables »).
Panneau Import/Export : nouvel onglet Multiples (à côté de Format de base / Impression pro / Scénario / Édition) avec les actions par lots : Convertir un dossier, Export multiple, Multi-format, Avec ressources. Les options avancées n'affichent que ce qui concerne le format choisi.
🧪 Vérifier ICML : dans le panneau d'export (format ICML), contrôle le document généré — hiérarchie, front matter, échappements, paragraphes vides — sans rien écrire sur le disque ; les détails apparaissent dans une fenêtre de l'application. La même vérification s'exécute de toute façon à chaque export ICML.
Export FDX plus sûr : le Markdown générique (listes, tableaux, notes) devient toujours Action — jamais Personnage/Dialogue par accident ; les vrais scénarios restent interprétés (scènes, personnages, répliques, transitions). \newpage devient un vrai saut de page (aussi en ICML, avec un style « Saut de page » remappable).
Impression via PDF : le bouton Imprimer génère un PDF temporaire (Typst, même typographie que les exports) et l'ouvre dans le visualiseur du système — impression depuis le dialogue natif avec un aperçu fidèle.
Paramètres réorganisés : section Installations (LaTeX en un clic, statut Ghostscript), langue en vue compacte, thème avec pastilles Sombre/Clair. Les prompts rapides du panneau IA sont repliables.

27. Analyse approfondie des fonctions (lacunes comblées)

Cette section couvre les fonctions avancées souvent inutilisées parce que peu visibles dans les menus.

27.1 IA : configuration, diagnostic et qualité des réponses

Endpoints cloud/local configurables (compatibles OpenAI, Ollama, LM Studio) via les variables PRESSWORK_AI_ENDPOINT, PRESSWORK_AI_MODEL, PRESSWORK_AI_API_KEY.
Diagnostic de connexion IA avec rapport JSON exportable (utile pour le support technique/les équipes informatiques).
Contrôle du style de réponse (synthétique/équilibré/détaillé), aperçu du prompt technique et relance du dernier prompt.
Épinglage endpoint/modèle par projet : maintient la cohérence éditoriale entre documents.

27.2 Statistiques : méthode de calcul (opérationnelle)

Productivité moyenne : calculée sur l'historique quotidien (7 jours / 30 jours).
Vitesse d'écriture : mots totaux divisés par la fenêtre des sessions (mots/heure et mots/min).
TTR (Type-Token Ratio) : mots uniques / mots totaux.
MSTTR : moyenne du TTR sur des fenêtres de 50 mots (réduit la distorsion sur les textes longs).
Flow state en temps réel : intervalle moyen entre frappes + taux de suppressions récentes.
Prévision d'achèvement : estimation optimiste/pessimiste avec les moyennes 7j vs 30j.

27.3 Exports avancés absents du guide rapide

Final Draft (.fdx) : mappe les titres en vrais Scene Headings, prend en charge notes/sauts de page/numérotation des scènes et génère le fichier annexe .breakdown.json.
ICML : mapping typographique avancé (titres/listes/citations/scénario) + préréglages + import d'un .icml personnalisé.
Assistant EPUB/ICML : bloque l'export tant que les métadonnées minimales (titre/auteur/ISBN) et la couverture ne sont pas définies.
Signature PDF : PKCS#7 detached + horodatage RFC 3161.

27.4 Mode Bundle (.pwk)

Action principale : Exporter avec choix de destination.
Cibles de sortie automatiques pour réduire les erreurs manuelles de chemin.
Interrupteur dans l'en-tête pour afficher temporairement les exports rapides classiques.

27.5 Collaboration (P2P) en conditions réelles

ID de session partageable pw-..., curseurs distants colorés, commentaires en ligne, synchronisation en direct.
Appel voix/vidéo intégré à la même session éditoriale.
Relais WebSocket de secours si WebRTC ne passe pas (réseaux d'entreprise/pare-feu), via la clé presswork-collab-relay-url.

27.6 Système de modèles (usage professionnel)

Import de fichier/dossier avec classement automatique (Business / Documents / UI Kit).
Prise en charge des modèles binaires et tableurs pour les flux de rapports.
Auto-appariement UI↔PDF pour lier le thème de l'éditeur et le style d'export, avec option Désapparier.

27.7 Liste de contrôle opérationnelle conseillée

Réglez le mode Base/Pro selon le livrable.
Vérifiez les prérequis dans Contrôle export (LaTeX/Ghostscript uniquement si PDF/X est nécessaire).
Exécutez le Préflight avant la livraison.
Pour EPUB/ICML, complétez l'assistant métadonnées + couverture.
Pour les documents signés, activez la signature PKCS#7 + horodatage.
En équipe, consignez l'ID de session Collab et le relais de secours dans la politique interne.

28. Connecter un assistant (MCP)

Depuis la 4.2, PressWork sert de pont MCP : les assistants IA de chat (Claude Desktop, Codex CLI, Gemini CLI…) lisent vos projets .pwk directement sur votre ordinateur — chapitres, notes, statistiques — sans copier-coller. Lecture seule : le pont n'a aucun outil d'écriture, seulement sept outils de lecture. Si l'assistant que vous connectez a ses propres outils d'accès aux fichiers de l'ordinateur, ceux-là ne passent pas par PressWork.

Configuration en un clic : Réglages → IA → Connecter un assistant (MCP) → « Configure pour moi » (Claude Desktop / Codex CLI / Gemini CLI). C'est le dossier du projet ouvert qui est connecté, avec tous les .pwk qu'il contient.
Fermez complètement l'assistant avant de configurer (Claude Desktop réécrit sa configuration à la fermeture), puis rouvrez-le. L'app sauvegarde la configuration avant d'écrire.
Les dossiers s'additionnent : configurez depuis des projets de dossiers différents et l'assistant les verra tous. Fonctionne même PressWork fermé.
Chez Claude : les chats normaux vivent dans le cloud et n'atteignent pas votre machine — choisissez l'activité « Sur ton ordinateur » ou cochez le connecteur presswork.
Autres clients MCP (Cursor, OpenCode…) : extrait de configuration manuel à copier. Avec Exporter la Compétence, vous générez la skill qui apprend à Claude à tirer le meilleur de vos projets (à ajouter une fois, valable pour toujours).
Confidentialité, dite honnêtement : ce que l'assistant lit est envoyé à son service cloud pour élaborer la réponse — comme un copier-coller, mais automatique. Ne connectez pas de projets que vous n'enverriez pas dans un chat.
Nécessite la vue de travail Complete.

29. Branches et variantes de chapitre

Deux outils différents qui répondent à la même question — « et si au contraire… » — à deux échelles différentes.

La branche est un autre livre. Dans chaque livre, chaque chapitre peut avoir ses variantes.

29.1 Les branches

Une branche est une version alternative du document entier : changer la fin, retirer un personnage, essayer une autre structure. Le document principal reste intact.
Panneau : Ctrl/Cmd+Shift+B ou depuis le menu. Ouvrir une branche, c'est y entrer : à partir de là vous écrivez dedans.
On voit toujours où vous êtes : une pastille avec le nom de la branche apparaît en bas de la fenêtre. Pas de pastille = vous êtes sur le document principal, celui qui part à l'impression.
Promouvoir fait de la branche le document réel (l'ancien principal est archivé comme branche). Diff compare ligne par ligne. Exporter détache la branche dans un .pwk indépendant.
Toutes les branches vivent dans le même .pwk : aucun fichier en plus, aucun Git.
Les fiches de la Synopsis disent où les routes se séparent : chaque fiche-chapitre porte une marque à la couleur de la branche là où ce chapitre diffère, barrée là où il n'existe pas. Un clic ouvre les Branches. Les fiches identiques dans toutes les branches restent nettes : le silence signifie « ici rien ne s'est séparé ». Depuis une branche, la comparaison inclut le document principal, qui est précisément celui auquel il faut se comparer en explorant une autre voie.
Les chapitres qui ne vivent qu'ailleurs ne disparaissent pas : au bas de la Synopsis apparaît, au besoin, la liste des chapitres qui n'existent que dans une autre version. C'est utile surtout pour les renommés, puisque les chapitres sont identifiés par leur titre.

29.2 Les variantes de chapitre

Une variante est une seconde version d'un seul chapitre : sur le papier, c'était barrer un passage et le réécrire à côté. Une seule reste vivante dans le texte, et c'est elle qui part dans les fichiers.
Créer : Synopsis → survolez la fiche du chapitre → ⑂ en haut à droite. Le texte actuel devient la première version ; vous nommez la nouvelle.
Basculer : cliquez la pastille ⑂ sur la fiche et choisissez. L'active porte la mention « dans le texte ». Seul ce chapitre change.
Supprimer : la corbeille du menu. L'active ne se supprime pas : passez d'abord à une autre.
Où cela se voit : barre d'état, à côté du compteur de mots — ⑂ variante : nom. Si le chapitre sous le curseur n'en a pas, c'est dit aussi, en gris.
Chaque branche a ses variantes : celles créées dans une branche n'apparaissent pas sur le principal, et c'est voulu.

29.3 Si quelque chose cloche

Chapitre renommé, variantes disparues : elles ne sont pas perdues. En bas de la Synopsis, la bande « Variantes sans chapitre » garde tout ce qui ne trouve pas sa place ; le menu « affecter à… » les remet au bon endroit. PressWork essaie de suivre seul les titres renommés, mais quand il n'est pas sûr il préfère vous montrer la matière plutôt que deviner.
Annuler vaut ici aussi : changer de variante est une modification comme une autre (Ctrl/Cmd+Z).
Sur le disque : versions/branches/<id>/ et versions/variants/ dans le .pwk. Ce sont de simples .md : même sans PressWork le travail se lit.