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 :

• Paramètres → App → Installations → Ouvrir le 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, Exporter, Affichage, 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.
• Chronologie (section Historique) : les points enregistrés tout seuls et leur restauration (Ctrl/Cmd + Shift + H).
• Versions (section Historique) : les versions alternatives du livre, à côté de la définitive qui part à l'impression (§29).

Flux conseillé :

1. Créez un document ou un projet.
2. Enregistrez souvent.
3. Utilisez la Chronologie pour revenir à un point antérieur.

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 (LaTeX/Ghostscript) : il n'est pas dans ce menu, mais dans Paramètres → App → Installations (« Ouvrir le contrôle export »).
• 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 : il n'est pas dans ce menu, mais dans Paramètres → Éditeur → Modes d'écriture (ou Ctrl + Alt + V).
• Collab : sessions collaboratives en temps réel avec invitation rapide par ID de session ; le texte, le chat et les pièces jointes passent par le relais de PressWork (§20).
  • 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 ; la voix et la vidéo passent par WebRTC, directement ou, si le réseau ne le permet pas, par un serveur de retransmission (TURN) : il n'y a rien à configurer.
• Tour : parcours guidé des formats spéciaux.
• Signature numérique : signe les PDF avec un certificat (Pro).

7. Menu Exporter

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 : parmi les Options d'impression pro (PDF). L'intérieur pour KDP sort toujours sans.
• 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 Affichage

• Modes : Écriture, Code MD, Vue page.
• Langue (9 langues) : elle n'est pas dans ce menu, mais dans Paramètres → App → Langue.
• Thème : Paramètres → App → Thème, 🌙 Sombre / ☀️ Clair, ou depuis la Command Palette.
• Machine à écrire (ligne centrée) : Paramètres → Éditeur → Modes d'écriture.
• Mode Focus : masque l'interface (F11).
• Présentation : diapositives plein écran.
• Accessibilité (taille du texte, haut contraste, police dyslexie) : elle n'est pas dans ce menu, mais dans Paramètres → Éditeur → Texte & Typographie.

9. Barre d'outils de l'éditeur

• Mise en forme : gras, italique, souligné. Le premier clic applique la mise en forme et laisse le mot sélectionné, le second le remet normal (cela vaut aussi pour le code).
• 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
• $E=mc^2$ dans la ligne, $$ … $$ sur une ligne à part : formule

Conseils

• Glissez-déposez les images.
• Utilisez Split ou Aperçu pour contrôler la mise en page.
• Formules, même hors ligne : l'aperçu les affiche sans connexion (au démarrage, PressWork ne télécharge rien). Ce qui est une formule dans l'aperçu sort comme formule dans le PDF, le PDF/X, Imprimer, le PDF rapide, l'ePub et le HTML, et inversement : un prix comme « $50 » reste du texte. Seuls Imprimer et le PDF rapide écrivent \cancel tel quel et font perdre sa couleur à \color, mais le PDF est quand même produit.
• Emoji : ils arrivent dans le PDF au lieu de petits carrés, en couleur dans le PDF standard et en noir dans le PDF/X.

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

• Métadonnées (barre du haut) ouvre 🏷 Gérer les métadonnées ; depuis l'Espace éditorial, Modifier les métadonnées (titre, auteur…) l'ouvre aussi : titre, auteur, langue, date, ISBN, maison d'édition, genre, tags.
• Langue, sous Titre et Auteur : chacune des neuf langues est écrite dans la sienne (Italiano, English (US), English (UK), Español, Français, Deutsch, 中文, Русский, العربية, עברית) ; avec Autre… on saisit un code comme pt-BR ou de-CH, et un code erroné n'est pas enregistré. La langue vaut pour l'ePub et pour les PDF : césure, guillemets, « Indice » ou « Contents ». Le chinois, le japonais et le coréen restent en italien dans le PDF via LaTeX et dans le PDF/X, et la fenêtre le signale. Avec Non indiquée, l'ePub prend la langue de l'application et le PDF l'italien.
• La langue devient la ligne lang: du document : si vous l'aviez écrite à la main, vous la retrouvez dans la fenêtre. Le champ Éditeur (la maison d'édition) et un ISBN valide arrivent dans l'ePub (l'ISBN ne va pas dans le PDF), et le format de page choisi là devient le Papier de l'export, même pour un .md.
• Front matter YAML pour des exports cohérents.
• EPUB : couverture et métadonnées fortement recommandées.

14. Projets et Mode Structure

1. Documents → Gérer le projet.
2. Créez le dossier du projet.
3. Ajoutez des chapitres (.md).
4. Réordonnez par glisser-déposer.
5. 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 ; la Langue des Métadonnées (§13) est celle avec laquelle la liseuse coupe les mots et lit à voix haute.
• 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)

• Espace éditorial (bouton en haut) : les outils pour Amazon KDP, en cinq onglets : Export, Couvertures, Validation, Calculateur, IA.
• 🚀 Exporter KDP (PDF + ePub) écrit les fichiers à téléverser : Titre_interior.pdf (PDF/X si LaTeX est installé, sinon un PDF standard ; toujours sans couverture et sans traits de coupe), Titre_ebook.epub et, si vous l'avez choisie dans l'onglet Couvertures, Titre_cover.pdf. À la fin, Ouvrir ouvre l'intérieur.
• Couvertures → Couverture du livre imprimé : l'onglet donne les mesures de la couverture complète (entière en mm et en pouces, le dos, le fond perdu), calculées sur le Papier choisi dans le menu Exporter (A4, A5, US Letter), avec le type de papier et le nombre de pages du Calculateur. Avec Choisir la couverture complète… vous choisissez la couverture déjà prête (PDF, JPG ou PNG) et PressWork en vérifie aussitôt les mesures : un PDF avec des traits de coupe doit être réexporté sans, il manque le fond perdu à une couverture faite au format rogné, et sous 300 DPI un avertissement s'affiche. Retirer la retire.
• Si les mesures ne correspondent pas, la couverture n'est pas écrite, et le message indique celles qu'il faut. Sans couverture, l'export se fait quand même, et la couverture se téléverse sur KDP. Le choix vaut pour le livre ouvert et ne reste pas après un redémarrage.
• Calculateur : à partir du nombre de pages et du papier (crème, blanc, Couleur standard, Couleur premium), il donne le dos et la marge intérieure minimale. La Couleur standard n'existe pas en A4 et ne s'imprime qu'à partir de 72 pages.
• Modèles KDP : trois squelettes de texte (Roman 6x9, Essai 6x9, Développement personnel 5x8) ; celui que vous choisissez, après une confirmation, remplace le texte de l'éditeur.
• 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. Avec une sélection, Insérer dans l'éditeur ne remplace pas : il propose, et vous décidez dans le texte (§36).
• 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

• 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)

1. Ouvrez Outils → Collab et choisissez un nom reconnaissable.
2. Créez une nouvelle session ou collez l'ID reçu d'un collègue.
3. Attendez le statut Online et vérifiez les participants dans le dock de collaboration.
4. Pour la voix/vidéo, lancez l'appel depuis le panneau Collab et utilisez les boutons muet/caméra.

Comment circulent les données

• Le texte, le chat et les pièces jointes passent par le serveur de connexion de PressWork (le relais), qui les transmet aux autres participants sans les enregistrer : il n'y a rien à configurer. Si le relais ne répond pas, PressWork essaie de relier les participants directement.
• La voix et la vidéo passent par WebRTC, directement entre les participants ou, si le réseau ne le permet pas, par un serveur de retransmission (TURN).
• La connexion est protégée pendant le trajet, mais le texte, le chat et les pièces jointes ne sont pas chiffrés de bout en bout : le serveur de connexion les voit pendant qu'il les transmet. C'est pourquoi la collaboration n'est pas adaptée aux documents confidentiels.
• Quiconque a l'ID de session peut entrer : ne le donnez qu'aux personnes que vous invitez, comme une clé.

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 : Paramètres → Éditeur → Texte & Typographie.
• Contraste élevé (menus et fenêtres) : dans la même section. Il change les menus, les barres et les fenêtres ; la page du texte reste telle quelle.
• Police adaptée à la dyslexie dans les menus : dans la même section. Elle utilise OpenDyslexic ou Atkinson Hyperlegible si elles sont installées sur le système (PressWork ne les fournit pas), et vaut pour les menus, pas pour le texte.

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é (un second appui les retire)
• Ctrl + Alt + V → Vim

25. Dépannage

• PDF/X indisponible : installez LaTeX + Ghostscript et redémarrez.
• Échec de l'export : lisez le message, il indique ce qui a échoué et où (§35).
• 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 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.
• Le texte, le chat et les pièces jointes passent par le relais de PressWork (on ne peut pas définir son propre relais), qui les transmet sans les enregistrer ; ils ne sont pas chiffrés de bout en bout, ce n'est donc pas l'outil adapté aux documents confidentiels (§20).

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

1. Réglez le mode Base/Pro selon le livrable.
2. Vérifiez les prérequis dans Contrôle export (Paramètres → App → Installations ; LaTeX/Ghostscript uniquement si PDF/X est nécessaire).
3. Exécutez le Préflight avant la livraison.
4. Pour EPUB/ICML, complétez l'assistant métadonnées + couverture.
5. Pour les documents signés, activez la signature PKCS#7 + horodatage.
6. En équipe, consignez l'ID de session Collab dans les consignes internes.

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. Il n'écrit jamais dans le texte : le pont a huit outils de lecture et, seulement sur les documents où vous l'autorisez, deux outils qui laissent des propositions que vous décidez (§36). Aucun outil ne modifie le texte. 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. Versions et variantes de chapitre

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

Une version est un autre livre. Dans chaque version, chaque chapitre peut avoir ses variantes.

29.1 Les versions

• Une version est une alternative du document entier : changer la fin, retirer un personnage, essayer une autre structure. La définitive, celle qui part à l'impression, reste intacte.
• Panneau : Ctrl/Cmd+Shift+B ou depuis le menu. Ouvrir une version, c'est y entrer : à partir de là vous écrivez dedans.
• On voit toujours où vous êtes : une pastille avec le nom de la version apparaît en bas de la fenêtre. Pas de pastille = vous êtes sur la définitive.
• Rendre définitive fait de la version le texte qui part à l'impression ; le texte précédent n'est pas perdu, il reste comme point dans la Chronologie et peut être restauré. Comparer montre les différences avec la définitive ligne par ligne. Copier dans un nouveau document… détache la version dans un .pwk indépendant.
• Toutes les versions 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 version là où ce chapitre diffère, barrée là où il n'existe pas. Un clic ouvre les Versions. Les fiches identiques dans toutes les versions restent nettes : le silence signifie « ici rien ne s'est séparé ». Depuis une version, la comparaison inclut la définitive, qui est précisément celle à laquelle 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 version a ses variantes : celles créées dans une version n'apparaissent pas sur la définitive, 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.

30. La vue Tableau, les remises et le reste de la 4.4

30.1 La vue Tableau et la date de remise

• Dans le Synopsis, la vue Tableau présente les chapitres sous forme de tableau : pour chacun l'objectif de mots, les mots écrits et l'Écart, c'est-à-dire la différence entre les deux. Faites glisser les lignes pour les réordonner ; le nouvel ordre s'applique au document réel.
• Le pied tient les comptes d'ensemble : objectif du document, ce qui est réparti entre les chapitres, ce qui reste à répartir. Pour l'impression, la dernière ligne estime les pages et indique combien il en manque pour le multiple de 16 (le cahier d'imprimerie).
• Dans la fenêtre 🎯 Objectifs (barre supérieure), vous pouvez ajouter une date de remise : le pied du Tableau dira combien de jours restent et combien de mots par jour il faut — en comptant les mots écrits, pas les objectifs. Elle est facultative et disparaît avec l'objectif quotidien ; objectif atteint, le rythme se tait.

30.2 La fenêtre de mise à jour

• Quand une nouvelle version sort, quelques secondes après le démarrage une fenêtre indique quelle version est disponible et laquelle vous avez. « Quoi de neuf » ouvre le journal des modifications dans votre langue ; « Mettre à jour » télécharge et redémarre ; « Plus tard » ferme sans insister — la proposition reviendra au prochain démarrage.

30.3 Les deux langues de l'assistant

• L'assistant vous parle dans la langue de l'application et écrit dans la langue du manuscrit : app en français et roman en anglais = explications en français, prose en anglais. Demandez explicitement une traduction quand vous voulez changer la langue du texte.

31. Importer un dossier Markdown (Notion, Obsidian, notes)

• Fichier & Projet → Importer un dossier Markdown : choisissez un dossier de fichiers .md — un export Notion (Exporter → Markdown & CSV avec les sous-pages, puis décompressez le zip), un coffre Obsidian (c'est déjà un dossier), ou un dossier de notes. PressWork affiche l'arborescence réelle et demande où commence le livre : les entrées de premier niveau sous le point choisi deviennent des chapitres, les plus profondes des sections. Un nouveau .pwk est créé à côté du dossier ; l'original n'est pas modifié.
• Notion et Obsidian sont reconnus automatiquement : codes hexadécimaux retirés des titres, petites bases → tableaux et grandes → Notes, lignes de bases exclues, encadrés → citations ; [[wikiliens]] et intégrations résolus par nom, front matter retiré. Les images sont copiées dans le document ; les liens entre pages du livre deviennent des renvois, ceux vers l'extérieur du texte.
• Le rapport final dit ce qui est entré et ce qui ne l'est pas — pages, chapitres, images copiées et introuvables, liens réécrits et devenus du texte, tableaux, fichiers laissés de côté, blocs de code refermés. Les entrées à zéro s'affichent aussi.

32. Enregistrer et exporter sous un nom, ouvrir depuis le système (4.5)

• Enregistrer sous… (Fichier & Projet, à côté d'Enregistrer) : sur un .md, enregistre une copie sous le nom choisi et l'on continue sur la copie ; sur un .pwk, duplique tout le document — texte, métadonnées, images, notes, historique, versions — et ouvre la copie, sans les sorties de exports/. Le titre de la section dit toujours quel fichier est ouvert (« Document · roman.pwk ») ; Enregistrer comme document .pwk n'apparaît que sur un .md.
• Exporter sous… (panneau Export, à côté de Générer) : ouvre toujours le dialogue du système pour le nom et le dossier, même là où l'export normal écrit sans demander. Le champ Nom de fichier est sous Format et le nom choisi est mémorisé par document, indépendamment du titre des métadonnées.
• Ouvrir avec : sur Mac et Windows, PressWork apparaît dans « Ouvrir avec » pour les fichiers .md sans en devenir l'application par défaut : après l'installation, un .md s'ouvre toujours avec le programme d'avant. Un double clic sur un .md associé à PressWork ouvre ce fichier, même l'application déjà ouverte. Sur Mac (depuis la 4.6), un .pwk est un document : le double clic ouvre PressWork ; pour regarder dedans, Afficher le contenu du paquet (clic droit), et les fichiers exportés s'ouvrent depuis la pastille de sortie ou depuis Partager. Sur Windows et Linux, un .pwk reste un dossier : on l'ouvre depuis les Récents, en le glissant dans la fenêtre ou depuis Ouvrir un document.

33. Dicter au lieu de taper

• Dicter au lieu de taper : PressWork utilise la dictée du système, qui écrit dans l'éditeur comme dans n'importe quel champ de texte, avec la ponctuation dictée (« virgule », « point »). macOS : deux fois fn ; sans fn, Réglages Système → Clavier → Dictée → Raccourci, par exemple « Appuyer deux fois sur Contrôle ». Windows : Win+H. Linux n'a pas de dictée système.

34. Où vous êtes et ce qui est enregistré (4.6, 4.7)

• Le nom du document est toujours visible : en bas à gauche, dans la barre d'état (en le survolant, on lit le chemin complet), et dans le titre de la fenêtre là où le système l'affiche. Sur une version, 🌿 et son nom apparaissent à côté, et en rouvrant un document laissé sur une version, PressWork revient sur cette version.
• Un .md avec des modifications non enregistrées a son nom en italique, précédé d'un « • ». Si vous fermez PressWork dans cet état, l'application demande s'il faut fermer sans enregistrer. Si vous fermez quand même, les modifications sont mises de côté : à la réouverture, PressWork rouvre le dernier .md et propose de les restaurer, puis il suffit d'enregistrer. Un .pwk s'enregistre tout seul et ne demande rien, tant que l'enregistrement réussit.
• Si un enregistrement échoue (le .pwk renommé ou déplacé depuis l'extérieur, le disque plein, les permissions, une clé USB retirée), l'état reste visible : le nom prend le « • », et l'indicateur en bas et la pastille en haut affichent ⚠️ Non enregistré jusqu'à ce qu'un enregistrement réussisse. Avant de fermer l'application, de passer à une autre version, de « Rendre définitive » ou d'ouvrir un autre document, la fenêtre « Le document ne s'enregistre pas » apparaît, avec la raison.
• Les choix de la fenêtre : « Réessayer d'enregistrer » (après avoir rebranché la clé ou libéré le disque), « Enregistrer une copie… » (le texte ailleurs), « Quitter sans enregistrer » à la fermeture ou « Continuer sans enregistrer » dans les autres cas, et « Annuler » pour rester. Si la sortie échoue ensuite, vous restez sur le document, et la fois suivante la question revient. Un document qui s'enregistre ne demande rien de plus.
• Si content.md est modifié avec un autre programme, un bandeau propose de le recharger.

35. Exporter et demander de l'aide (4.6, 4.7)

• L'export se souvient du dernier dossier utilisé pour chaque document, sur cet ordinateur. Si vous changez le titre, dans exports/ le fichier à l'ancien nom est remplacé par celui au nouveau nom, pour ne pas envoyer le mauvais.
• Après l'export, le message « Export terminé : … » a deux boutons : Ouvrir ouvre le fichier, Afficher dans le dossier le montre déjà sélectionné. Ils sont là aussi après un PDF/X ou avec un avertissement, et le message reste tant que vous gardez la souris dessus ; après l'export KDP, « Ouvrir » ouvre l'intérieur.
• Si un export échoue, le message dit ce qui n'a pas marché et où, dans la langue de l'application : la commande LaTeX inconnue et près de quelle phrase, le paquet LaTeX qui manque et comment l'installer, l'erreur de Typst avec sa ligne, le front matter YAML cassé. S'il manque des images, il dit combien, la première et le dossier où il les a cherchées.
• Word et ODT sortent avec le format de page et les marges du PDF ; l'ePub a une table des matières et la feuille de style de PressWork, même en exportant un seul document.
• Les grandes photos, par exemple celles du téléphone en pleine résolution, s'affichent dans l'éditeur et l'aperçu à partir d'une copie réduite, créée la première fois en une seconde : l'application ne se bloque pas, et les exports utilisent toujours la photo originale.
• Pour l'assistance : fenêtre Infos → « Copier les informations pour l’assistance ». Elle copie la version, le système et les moteurs d'export installés, sans texte ni nom de fichier : collez-la dans votre message.

36. Révisions et propositions, décidées dans le texte (4.7)

• Chaque marque de révision a ses boutons. À côté d'un ajout, d'une suppression ou d'un remplacement, il y a ✓ (accepter) et ✗ (refuser) ; un surlignage ou un commentaire ont ✓ (fait : retire la marque et garde le texte). On décide là où se trouve la marque, une par une ; Annuler (Ctrl/Cmd+Z) revient en arrière.
• Les assistants peuvent proposer, jamais écrire. Un assistant connecté par le pont MCP (§28) — Claude, Codex, Gemini — ne peut laisser des propositions que sur les documents où vous l'autorisez : clic sur le nom du document en bas → « Les assistants peuvent proposer des modifications ». Tant que c'est activé, ✎ Propositions IA activées s'affiche à côté du nom : un clic le désactive. Sur les nouveaux documents, c'est désactivé.
• Les propositions attendent hors du texte. Quand elles arrivent, ✎ Propositions de Claude : 3 apparaît : un clic les place dans le texte sous forme de marques, avec le nom de qui propose et le pourquoi (@Claude: …), à décider avec ✓ et ✗. Annuler les retire toutes d'un coup. Elles n'entrent jamais seules : le texte ne bouge pas pendant que vous écrivez.
• L'IA intégrée à PressWork propose aussi. Avec une sélection, dans le panneau IA, Insérer dans l'éditeur place son texte comme proposition, avec ✓ et ✗ (sur plusieurs lignes, chaque ligne se décide à part), et tant que vous ne l'acceptez pas, c'est le texte d'avant qui part à l'impression. Sans sélection, le texte s'ajoute au curseur, comme avant. Avec une sélection, l'IA répond avec le nouveau texte, rien d'autre.
• Toutes d'un coup. À côté de ✓ ✗ d'une proposition, il y a ▾, avec « Accepter toutes les propositions de AI (15) » et « Refuser toutes les propositions de AI (15) » : elles valent pour l'auteur de cette proposition, et les propositions des autres auteurs comme vos propres révisions restent où elles sont. Annuler les ramène toutes.
• Si vous avez modifié cette phrase entre-temps, la proposition ne touche à rien : la pastille la compte parmi les « plus applicables » et elle est écartée.
• Ce que vous n'avez pas décidé ne part pas à l'impression. Une proposition en attente reste hors de l'aperçu et de tout export, comme si elle était refusée, et le menu Export indique combien il y en a. Vos propres révisions restent acceptées comme toujours.
• Aussi les notes et les synopsis. Un assistant peut proposer une nouvelle note (note, recherche, personnage) ou le synopsis d'un chapitre. Avec la pastille, ils arrivent à leur place : la note dans le panneau Notes avec l'étiquette « ✎ @Claude », le synopsis sur la fiche du chapitre, dans un encadré. Vous les gardez ou les écartez là ; rien n'écrase ce que vous avez déjà écrit.
• Les propositions valent pour la version définitive, pas pour les autres versions.