Aller au contenu principal

Chapitre 17 · Partie III · En pratique

Skill pour agents : porter une publication vers Postext

Installez le skill postext-port dans Claude Code, Codex ou tout autre agent, et laissez-le transformer une source PDF, Word, PowerPoint, EPUB, InDesign ou HTML en un projet Postext qui suit la mise en page de l’original

Mis à jour 2026-10-2111 minenescadefritptzhjaar

En bref

Cette page s’adresse aux personnes qui ont déjà un livre ou un document dans un autre format, comme PDF, Word ou InDesign, et qui veulent le passer dans Postext. Un assistant d’intelligence artificielle, appelé agent, peut faire l’essentiel du travail si vous lui donnez un petit module appelé skill. Le skill apprend à l’agent à reprendre le texte et à reconstruire la maquette de l’original. La page explique comment l’installer, quoi demander et comment vérifier le résultat. Une vidéo d’environ cinq minutes montre chaque étape.

Transformer une publication existante en projet Postext avec un agent de programmation.

Beaucoup de gens arrivent à Postext avec un livre qui existe déjà : un manuel en PDF d’impression, un rapport sous Word, un cours sous PowerPoint, un catalogue sous InDesign, un EPUB. Le porter dans Postext demande deux tâches :

  • Le contenu : le Markdown enrichi de chaque chapitre, avec ses directives et ses microformats.
  • La maquette : un manifeste de configuration qui reproduit les règles de mise en page de l’original (géométrie de la page, grille de ligne de base, caractères, ouvertures, titres courants, encadrés, flottants, tableaux, parties).

Un LLM peut faire une bonne partie de ce travail, mais seulement s’il sait comment fonctionne Postext. Le Markdown de Postext n’est pas du CommonMark, et la configuration a des pièges qui n’apparaissent que lorsqu’une page sort mal. Le skill postext-port réunit ce savoir et les outils avec lesquels nous avons construit chaque préréglage du Sandbox, pour que votre agent fasse le portage correctement.

Il suit le format ouvert Agent Skills et fonctionne donc avec Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode et beaucoup d’autres agents.

#Regarder le tutoriel

Cinq minutes, sans code : préparer le dossier, apporter les originaux vectoriels, ajouter un PDF de référence, faire la demande à l’agent et vérifier le résultat dans le Sandbox.

Transcription

Tout ce que dit le narrateur, avec une description de ce qui apparaît à l’écran.

  1. 0:00

    À l’écranCarte de titre : le logo de Postext, le surtitre « Tutoriel · 5 étapes » et le titre « Convertissez votre publication en Postext avec un agent IA. Sans code. »

  2. 0:03

    À l’écran« Votre publication existe déjà. » Trois publications arrivent l’une après l’autre avec leurs étiquettes : un livre, Madame Gervaisais, d’Edmond et Jules de Goncourt, marqué InDesign (IDML) ; un manuel, le mode d’emploi de la bouilloire électrique Verra W1, marqué Word (DOCX) ; et un magazine, le reportage « La route du sel » de Lena Varga, marqué PDF. Elles se rassemblent à gauche, une flèche dorée en pointillés traverse un badge « Agent IA » et une icône de fichier nommée mon-livre.postext apparaît, sous « Un agent la convertit en Postext. Cinq étapes. Quelques demandes bien écrites. »

    NarrationVous avez déjà une publication : un livre, un manuel, un magazine. Elle vit dans InDesign, dans Word ou dans un PDF. Dans ce tutoriel, un agent d’intelligence artificielle va la convertir en Postext pour vous. Sans programmer : cinq étapes et quelques demandes bien écrites.

  3. 0:23

    À l’écran« Le plan » : cinq cartes numérotées apparaissent à mesure que chaque étape est nommée : 01 Préparez le dossier, 02 Réunissez les originaux vectoriels, 03 Ajoutez une référence, 04 Demandez à l’agent, 05 Vérifiez dans le Sandbox.

    NarrationLe plan : préparer le dossier, réunir les originaux vectoriels, ajouter une référence, le demander à l’agent et vérifier le résultat.

  4. 0:34

    À l’écranÉtape 01, le dossier : « Un projet, un dossier. » Un grand dossier, mon-livre/, flotte parmi dix fichiers épars comme MinionPro-Regular.otf, couverture.jpg, fig-2-1.ai, chapitre-01.docx, carte.svg, livre.idml et graphique.pdf. Une fenêtre s’ouvre sur l’arborescence du dossier et chaque fichier s’envole vers son sous-dossier à mesure qu’il est nommé : reference.pdf (le rendu voulu → étape 03), polices/ (Minion Pro, Myriad…, .otf .ttf .woff2), images/ (photographies, .jpg .png), illustrations/ (originaux vectoriels, .ai .svg .pdf) et textes/ (Word, InDesign (IDML)…).

    NarrationPremière étape : réunissez tout dans un seul dossier sur votre ordinateur. Un projet, un dossier. À l’intérieur, donnez à chaque type de matériel son propre sous-dossier : les polices, les images, les illustrations et les textes.

  5. 0:51

    À l’écranLa ligne polices/ est mise en évidence et une carte intitulée « Polices » montre un grand « Aa », les styles Romain, Italique et Gras, les formats OTF, TTF et WOFF2, et la note « Seules celles que vous fournissez servent. » Puis « Plus c’est rangé, moins l’agent devine. », tandis que chaque sous-dossier de l’arborescence reçoit une coche.

    NarrationN’oubliez pas les polices : elles sont la voix de la maquette, et l’agent ne peut utiliser que celles que vous fournissez. Plus le dossier est bien rangé, moins l’agent aura de choses à deviner.

  6. 1:03

    À l’écranÉtape 02, les originaux vectoriels : « Réunissez les originaux. » Un schéma, un graphique et une carte sont tracés au trait, leurs points d’ancrage visibles, et trois icônes de fichier apparaissent : .ai Illustrator, .svg SVG et .pdf PDF.

    NarrationDeuxième étape : si vos illustrations sont vectorielles, comme des schémas, des graphiques ou des cartes, retrouvez les fichiers originaux : Illustrator, SVG ou PDF.

  7. 1:15

    À l’écranDeux panneaux montrent la même figure, un schéma où Manuscrit et Modèle pointent tous deux vers Pages, avec la légende « Fig. 2.1 Contenu et maquette se rencontrent. » À gauche, « Découpée dans le PDF : une photo du dessin » devient floue et pixelisée à mesure que la vue zoome ; à droite, « L’original : le dessin lui-même » reste net. Le panneau de gauche s’efface, les étiquettes de l’original sont retapées en anglais (Manuscript, Template, Pages), des traits de coupe l’encadrent et trois coches indiquent « Nette à toute taille », « Étiquettes en texte réel » et « Original → imprimeur ».

    NarrationUne figure découpée dans le PDF final n’est guère plus qu’une simple photo du dessin. L’original, c’est le dessin lui-même. Avec l’original, l’agent recompose chaque figure : nette à toutes les tailles, avec ses étiquettes en vrai texte, prêtes à traduire. Et à l’impression, l’original part tel quel.

  8. 1:35

    À l’écranÉtape 03, la référence : « Montrez le résultat attendu. » Dans l’arborescence, reference.pdf est mis en évidence et étiqueté « À la racine » ; une page s’en échappe et devient une grande page de livre sur deux colonnes marquée reference.pdf.

    NarrationLa troisième étape est essentielle : à la racine du dossier, placez un fichier qui montre clairement à quoi doit ressembler le produit final. L’idéal, c’est un PDF.

  9. 1:45

    À l’écranDes mesures apparaissent sur la page : les contours des colonnes, une gouttière de 9 mm, une marge de 20 mm, des étiquettes pour le titre (Fraunces 28 pt), le texte (Lora 9,4/13,6 pt) et un encadré (fond, 1 filet), et des lignes de base avec un interlignage de 13,6 pt. Un fichier, cahier-des-charges.md, se remplit : page de 210 × 280 mm ; marges de 24 · 20 · 22 · 20 mm, symétriques ; 2 colonnes, gouttière de 9 mm ; grille de base de 13,6 pt ; texte en Lora 9,4/13,6 pt, justifié ; titres en Fraunces 28 pt · Geist ; ouvertures avec un bandeau de couleur de 101 mm ; encadrés avec un fond et un filet à gauche. Puis le mot « Deviner » est barré et « Mesurer. » s’allume en doré.

    NarrationL’agent lit la maquette dans ces pages : il mesure les marges, les colonnes, les polices et les espacements, et les note sous forme de règles de mise en page. Sans référence, il devrait deviner. Avec elle, il mesure.

  10. 2:00

    À l’écranÉtape 04, l’agent : « Demandez-le avec vos mots. » Une fenêtre intitulée « Agent · ~/mon-livre » s’ouvre à côté des badges Claude Code, Codex et « ou tout autre agent ». Un message de VOUS s’écrit : « Installez le skill Postext : `npx skills add drnachio/postext --skill postext-port` », et l’agent répond « ✓ Skill installé : postext-port ». Une carte du skill postext-port énumère « Une méthode éprouvée », « Tout sur Postext » et « Des outils pour vérifier son travail ».

    NarrationQuatrième étape : ouvrez votre agent, Claude Code, Codex ou celui que vous utilisez, dans ce dossier, et demandez-lui d’installer le skill Postext. Un skill est un paquet de savoir-faire expert. Celui-ci apprend à l’agent à convertir une publication en Postext, et lui donne des outils pour vérifier son propre travail.

  11. 2:20

    À l’écranLa demande suivante s’écrit : « Utilisez le skill postext-port pour convertir ce livre en Postext. La maquette est dans reference.pdf, les polices dans polices/ et les illustrations originales dans illustrations/ : utilisez-les au lieu de découper les figures du PDF. Commencez par le chapitre 1 seulement et montrez-moi le cahier des charges avant de le construire. » À côté, reference.pdf, polices/ et illustrations/ s’allument dans l’arborescence à mesure que la demande les nomme, et une carte « Chap. 1 » surgit.

    NarrationEnsuite, demandez-lui ce que vous voulez, avec vos mots. Dites-lui où se trouvent la référence, les polices et les originaux, et de commencer par un seul chapitre.

  12. 2:33

    À l’écranUne grille de douze pages de livre estompées ; la première est cernée d’or. Une flèche circulaire y compte les tours de finition jusqu’à l’apparition d’une coche, puis les onze autres s’allument. En dessous : Chapitre d’essai → Peaufiner → Étendre.

    NarrationSi le contenu est long, commencez par un chapitre d’essai. Peaufinez-le jusqu’à ce qu’il soit parfait, et seulement ensuite, étendez-le au reste.

  13. 2:42

    À l’écranL’agent demande « Copie fidèle ou refonte ? », « Quelles langues ? » et « Papier, écran ou les deux ? ». Une liste de contrôle déroule Faire l’inventaire, Mesurer la maquette, Extraire le texte, Polices et images, Comparer page à page et Empaqueter le fichier, et le fichier mon-livre.postext apparaît. Une troisième demande s’écrit : « Le chapitre 1 est validé. Convertissez les autres chapitres avec la même maquette, comparez chacun avec reference.pdf et empaquetez le tout dans un seul fichier .postext. » L’agent répond « ✓ 12 chapitres · 0 avertissement · mon-livre.postext ».

    NarrationL’agent vous posera quelques questions : copie fidèle ou nouvelle maquette, quelles langues, papier ou écran. Puis il mesure, extrait, assemble et vérifie, et vous remet un fichier Postext. Une fois l’essai au point, il suffit d’une demande de plus pour l’étendre à tout le livre.

  14. 3:04

    À l’écranÉtape 05, le Sandbox : « Vérifiez-le page par page. » Une fenêtre de navigateur tape l’adresse postext.dev/fr/sandbox. Le pointeur clique sur Livres dans la barre latérale, puis sur Nouveau, puis sur « Ouvrir un fichier .postext… » ; le fichier arrive en volant, « Mon livre, 12 chapitres · 184 pages » apparaît en haut de la liste et ses premières pages s’ouvrent dans la vue Canvas ; les onglets de vue indiquent Canvas, HTML, PDF, Folio et EPUB 3.

    NarrationCinquième étape : ouvrez le Sandbox de Postext, sur postext.dev. Dans Livres, choisissez Nouveau et ouvrez votre fichier.

  15. 3:14

    À l’écranLa page de référence et la page Postext se tiennent côte à côte, étiquetées Référence et Postext, et une ligne dorée les parcourt de haut en bas. Le panneau Vérifications s’ouvre avec un badge à 3 et liste Veuve (p. 4), Ligne lâche (p. 7) et La figure ne tient pas (p. 9) ; des cadres rouges marquent chaque problème sur la page Postext.

    NarrationParcourez-le page par page, à côté de votre référence. Le panneau Vérifications vous signale les problèmes : veuves, lignes lâches, figures qui ne tiennent pas.

  16. 3:26

    À l’écranDeux rangées de maquettes filaires de pages, « Référence · PDF » et « Postext · recomposé ». Dans la rangée recomposée, une figure passe de la première page au haut de la deuxième, et une ligne pointillée relie ses deux positions. Texte : « Les mêmes règles, pas les mêmes pages. Le contenu s’écoule : une figure ou un saut de page peut tomber ailleurs. » Puis un signe égal relie chaque paire de pages sous « Ce qui doit correspondre » : Marges et grille de base, Typographie, Style des figures et des encadrés, Pages propres : sans veuves, colonnes équilibrées. Un panneau rouge marqué ≠ indique « Décisions d’artisan, à la main » et « pas des règles : inutiles pour un contenu qui change ».

    NarrationGardez bien une chose en tête : les pages n’ont pas besoin d’être identiques à celles du PDF. Postext a compris les règles de mise en page, et votre contenu est maintenant fluide : une figure ou un saut de page peuvent donc tomber à un autre endroit. Ce qui doit correspondre, c’est la qualité : le même niveau de finition. Quand on met en page à la main, on prend de petites décisions d’artisan qui ne sont pas des règles. Et seules des règles permettent de mettre en page un contenu qui change.

  17. 3:54

    À l’écranLa fenêtre de l’agent revient avec une quatrième demande : « Dans le Sandbox, chapitre 2, page 7 : l’encadré “À retenir” est coupé sur deux colonnes et le titre courant manque. Vérifications signale 3 lignes lâches. Corrigez-le et empaquetez de nouveau le fichier. » Une capture d’écran est jointe, capture-chap2-p7.png. Puis une boucle entre Sandbox (vérifier) et Agent (corriger) parcourt les tours 1 à 3 tandis que le nombre d’avertissements tombe de 3 à 0, et se termine par une coche et « Parfait. »

    NarrationPuis dites à l’agent ce que vous voyez, le plus précisément possible : le chapitre, la page et ce qui ne va pas. Une capture d’écran aide. Ouvrez la nouvelle version, revérifiez, et recommencez. Chaque tour vous rapproche, jusqu’à ce que ce soit parfait.

  18. 4:13

    À l’écran« Pas seulement une version Postext. » Le fichier mon-livre.postext se scinde en deux le long d’une ligne dorée. À gauche, Contenu (ce qu’il dit) : chapters/fr/02-la-cellule.md, avec le titre « La cellule », une phrase qui renvoie à la figure fig-cellule et un encadré « retenir ». À droite, Forme (son apparence) : un « modèle · déduit de votre original », avec une page de 210 × 280 mm symétrique, 2 colonnes avec une gouttière de 9 mm, un texte en Lora 9,4/13,6 justifié, des titres en Fraunces numérotés, des encadrés « À retenir » avec fond et filet, et des figures en tête de colonne.

    NarrationEt voici le meilleur : vous n’avez pas seulement votre contenu en Postext. Vous avez séparé le fond de la forme. Le texte vit dans des chapitres propres ; la maquette, dans un modèle avec les règles de mise en page déduites de votre original.

  19. 4:28

    À l’écranLes pastilles Corriger, Enrichir et Traduire s’allument au-dessus d’une rangée de pages de livre : une ligne est surlignée et un reflet traverse les pages, deux pages de plus arrivent en glissant, et les pages se retournent sur l’édition anglaise. Une demande s’écrit : « Ajoutez une édition anglaise : traduisez les chapitres, les légendes des figures et les étiquettes des schémas, et gardez la même maquette. » Légende : « Mêmes règles. Nouveau contenu. Les pages se composent seules. » Puis « Un fichier, tout le livre. » : une icône .postext se ramifie vers une page avec des traits de coupe (PDF pour l’impression), une liseuse dont le texte se recompose à la taille de son écran (Livre EPUB), une fenêtre de navigateur (Lecteur web) et une paire de pages (Chaque page, composée).

    NarrationAinsi, quand votre contenu changera, quand vous le corrigerez, l’enrichirez ou le traduirez, vous n’aurez pas à vous soucier de la mise en forme. Postext le recompose avec les mêmes règles. Un seul fichier pour tout le livre : un PDF prêt pour l’imprimeur, un livre numérique EPUB, un lecteur pour le web et des pages qui se composent toutes seules.

  20. 4:50

    À l’écranCarte de fin : le logo de Postext, le slogan « Le compositeur programmable pour le web », postext.dev, une pastille indiquant « Les prompts de cette vidéo sont dans la description ↓ » et le pied « Open source · MIT · github.com/drnachio/postext ».

    NarrationPostext. Open source, sur postext.dev. Vous trouverez les exemples de prompts dans la description.

Également sur YouTube : regardez-la directement ou dans la playlist Postext.

Modifiez un livre Postext avec un agent IA : chapitres, nouvelles éditions, adaptations — tutoriel 2Regarder sur YouTube (s’ouvre dans un nouvel onglet) · Le lecteur se charge depuis YouTube lorsque vous lancez la lecture.

#Ce que contient le skill

  • Une méthode de travail :
    1. s’accorder sur le cahier des charges ;
    2. faire l’inventaire de la source ;
    3. mesurer la maquette et la consigner dans une fiche technique ;
    4. créer la structure du projet ;
    5. extraire le contenu ;
    6. le mettre au propre en Markdown Postext ;
    7. préparer les polices et les images ;
    8. vérifier page par page ;
    9. empaqueter le tout.
  • Des références :
    • le format du document et le manifeste de configuration, tous deux vérifiés par rapport au moteur ;
    • le format du projet (paquet) ;
    • un guide pratique par format de source ;
    • une méthode d’analyse de la maquette ;
    • un catalogue de cas de mise en page résolus : parties avec leurs propres couleurs, ouvertures de chapitre, vers, gloses marginales, notes de bas de page, index, encadrés flottants, coupés ou imbriqués, originaux vectoriels pour l’impression, figures en texte réel, images dans des cellules de tableau, tableaux à l’italienne, éditions bilingues, et d’autres encore ;
    • les livres chinois, composés horizontalement ou verticalement et reliés à droite : quoi demander dans le cahier des charges (écriture, région, sens, reliure), comment mesurer une grille de caractères, comment extraire le texte de PDF verticaux, le ruby et le warichu d’InDesign, la mise en page est-asiatique de Word et les EPUB de droite à gauche, et comment réduire les polices CJK aux caractères du livre (voir Mise en page chinoise) ;
    • les livres japonais, romans bunko et tankōbon verticaux reliés à droite ou livres techniques horizontaux : la langue qui active les règles japonaises (ja, jamais une balise chinoise), quoi demander (sens, grille, furigana, notes, orthographe de l’édition), comment mesurer la zone de contenu en caractères et en lignes, le balisage des furigana et des bōten, les textes d’Aozora Bunko convertis avec aozora.py, les numérisations d’éditions du domaine public de la Bibliothèque nationale de la Diète, et des polices japonaises réduites avec leurs kana et leurs formes verticales (voir Mise en page japonaise) ;
    • les livres arabes, modernes ou classiques et vocalisés, composés de droite à gauche et reliés à droite : la langue qui fait passer tout le livre de droite à gauche, quoi demander (région et chiffres, vocalisation, vers, table des matières à la fin), comment mesurer une page en miroir, comment extraire l’arabe de PDF, de Word et de Wikisource, les poèmes en :::verse, les notes « (١) » par page, et des polices arabes réduites avec leurs tables de liaison (voir Mise en page arabe) ;
    • la bande dessinée, les mangas et les strips de presse : l’expression de découpage qui divise une planche en cases, les images des cases avec leurs ancres de locuteur et leurs zones de sécurité, un script par langue, que le moteur lettre (bulles, récitatifs, onomatopées), les mangas et les éditions arabes de droite à gauche, et comment porter à partir d’images sans texte accompagnées de traductions, de numérisations déjà lettrées ou d’un script avec des images générées (voir Bande dessinée) ;
    • les pages composées : les pages fixes de manuels, de cahiers et de magazines portées en gabarits de page dont les blocs se remplissent depuis le Markdown, la passe de portage que gère le Postext installé et les vérifications que chaque édition doit passer (voir Pages composées) ;
    • l’objet imprimé : comment relever le papier, la reliure, les couvertures et le dos de la source et les traduire en réglages folio qu’affiche la visionneuse Folio, vérifiés par le linter.
  • Des scripts (Python et Node), décrits dans la section suivante.

#Scripts

ScriptCe qu’il fait
inventory.pyPremier examen de n’importe quelle source : géométrie, polices, styles utilisés, médias, pages qui demandent une OCR ; pour un PDF imprimé en PDF/X, sa condition de sortie et son fond perdu, avec les réglages print qui les reproduisent.
measure_layout.pyMarges, colonnes, gouttière et interlignage (la grille de ligne de base) d’un PDF
pdf_extract.pyPDF → brouillons de chapitres par rôle typographique (police/taille/couleur) : ordre de lecture, paragraphes, suppression des césures, gras/italique, exposants et indices, listes, légendes
pdf_figures.pyDécoupe les figures d’un PDF : photos en résolution native, aperçus SVG, masters PDF vectoriels pour l’impression
pdf_regions.py, template_dedupe.py, anchors.pyTransforme les pages fixes d’un PDF (manuels, cahiers d’exercices, magazines) en pages composées : gabarits de page avec des blocs en mm ; styles d’encadré, d’onglet et de surlignage ; un fond de page sans texte ; les images découpées sans leur texte ; et un Markdown avec un délimiteur de page (la section ::::page) par page et un emplacement par encadré, dans l’ordre de lecture. Le texte masqué par un autre élément peint est écarté. template_dedupe.py réunit en une seule bibliothèque les gabarits et les styles des pages d’un même type, nomme les blocs d’après leur rôle (box-light-blue, caption-of-picture) plutôt que d’après leur genre et leur rang, et met à jour les délimiteurs de page en conséquence. anchors.py transforme les noms d’une carte en ancres de la ressource et en lignes ::label pour chaque édition. Quand une passe ne compte qu’une page, et qu’il n’y a donc rien à fusionner, pdf_regions.py extract nomme lui-même les blocs d’après leur rôle (--name-frames, depuis postext 1.43). Depuis postext 1.48, il dessine en vectoriel les lignes, les cartes et les formes de la page (connecteurs entre blocs, lignes qui désignent un point d’une image, tracés) au lieu d’une image par page, et template_dedupe.py transforme les cartes disposées en lignes et en colonnes en grilles répétées, et chaque bande de la page en module. Depuis postext 1.50, il place aussi en une rangée de modules les blocs posés côte à côte, garde dans une seule grille les cartes qui ne diffèrent que par la couleur, chacune avec un aspect nommé, et donne aux pages liminaires et aux pages courantes un seul gabarit de base, dont le folio et la couleur de page s'impriment quand le bloc ::::page le demande. Depuis postext 1.51, le brouillon demande moins de retouches : une image est découpée sans rien d'autre que l'image (les lettres cachées, les aplats voisins et les marges blanches restent dehors), la plaque que la page peint sur une photo reste au-dessus, le texte d'un encadré va jusqu'au bord de l'encadré, les ornements à côté d'un titre courant se déplacent avec lui, les légendes composées en colonnes sous les images reçoivent chacune un cadre, une couleur à laquelle le livre donne déjà un nom le prête à l'aspect qui l'utilise, et les blocs que le brouillon enchaîne l'un sous l'autre peuvent encore former une rangée de modules. Les corrections faites à la main vont dans curation.json, que extract écrit vide et que manifest applique après chaque génération, si bien qu’une nouvelle génération les garde : blocs corrigés, supprimés ou ajoutés, décor supprimé, chevauchements admis, styles modifiés et ressources ajoutées, chacun avec sa raison ; une correction dont le gabarit, le bloc ou le style n’existe pas arrête la génération.
extract_tables.pyTableaux PDF → TableModel Postext : les cellules gardent leur alignement, leur gras et leur fond, les cellules fusionnées leur étendue, une ligne de titre devient la légende et l’étiquette du tableau, une ligne qui couvre toutes les colonnes un bandeau de groupe centré, les lignes d’en-tête se comptent au gras ou au fond, et deux lignes lues comme une seule sont séparées. pdf_extract.py transforme lui-même les tableaux à filets en ressources de tableau.
pandoc_to_postext.pyDOCX, PPTX, ODT, EPUB, HTML, LaTeX, Markdown, JATS, DocBook → brouillons de chapitres, avec les styles Word associés à des encadrés et à des styles de paragraphe
idml_extract.pyIDML d’InDesign → brouillons de chapitres par style de paragraphe, tableaux et images ancrées ; le ruby, le tate-chu-yoko, les signes d’emphase et le warichu deviennent :ruby, :tcy, :dots et :warichu, et les blocs de texte verticaux et une reliure de droite à gauche sont signalés
aozora.pyTexte d’Aozora Bunko (un zip CP932 ou un .txt) → Markdown Postext : furigana, bōten et traits latéraux, titres avec leurs retraits, blocs 字下げ et 地付き en styles de paragraphe, sauts de page, 外字 résolus via JIS X 0213, signes de kanbun ; il renvoie le bloc de crédits et un rapport de ce qu’il n’a pas pu exprimer
index_marks.pyReconstruit un index imprimé sous forme de marques :index : lit les pages d’index du PDF, retrouve chaque terme sur sa page et marque les mêmes mots dans les chapitres
comic_panels.pyMesure les pages de bande dessinée : trouve les cases grâce au papier qui les sépare, écrit l’expression split (de gauche à droite ou de droite à gauche, gouttières obliques comprises), les gouttières et le cadre, découpe une image par case et imprime les squelettes :::page ; pose une grille sur les images pour relever les ancres de locuteur et les zones de sécurité, et les redessine pour les vérifier
fonts.py, images.py, convert_assets.pyInstancier, réduire, mettre à l’échelle et scinder des polices (une fonte chinoise ou japonaise réduite aux caractères du livre garde ses formes et ses métriques verticales, une fonte arabe ses formes liées et le tatweel) ; convertir les images en sRGB, les rogner et les assembler ; transformer des illustrations .ai/.pdf en SVG
preset_kit.pyCrée la structure du projet et son script générateur, construit preset.json, empaquette le fichier .postext et vérifie la configuration : il signale le texte du livre saisi dans des éléments de maquette (la configuration ne doit contenir que la maquette) et une configuration trop lourde pour le Sandbox
lint_project.pyDétecte tout ce que l’analyseur et le chargeur interprètent mal sans rien dire et, pour le texte chinois, japonais et coréen, les caractères que les polices fournies ne savent pas composer ; pour le texte japonais, les kana sous une langue chinoise, les fontes ou réglages chinois, la notation Aozora restée dans les chapitres et les entrées d’index en kanji sans lecture ; pour le texte arabe, une langue arabe manquante, des fontes uniquement latines ou sans liaisons, l’interlettrage, la césure forcée et l’emphase en italique ; en bande dessinée, les expressions de découpage invalides, les cases qui ne correspondent pas aux cellules, les images et les styles de bulle ou de case inconnus, les ancres de locuteur mal formées, les fontes de lettrage que le projet ne fournit pas, et les éditions dont les pages diffèrent. Il signale aussi ce qu’un agent laisse derrière lui : des marques en ligne dans un texte de dessin sans inlineMarks, une espace ordinaire tapée à côté d’une espace fixe, une puce dans un titre avec un moteur antérieur à 1.52, des capitales tapées dans une puce réduite au lieu de :smallcaps[…] et un ::: après une directive d’une ligne comme :::toc ; sa liste de réglages de configuration vient des types du moteur lui-même
render.mjsMet le projet (un dossier ou un fichier .postext) en page sans interface avec le vrai moteur, en lisant sa configuration comme le fait le Sandbox, et imprime les avertissements. Avec --jpeg, il dessine les pages demandées (--pages 12-15) en fichiers JPEG avec le moteur de rendu canvas de Postext lui-même, en une seconde ou deux : l’agent voit ainsi ses pages sans construire de PDF ; --out écrit le PDF. Un livre préparé pour l’impression reçoit des lignes PREFLIGHT (images en basse résolution, filets fins, petit texte en plusieurs encres, encrage au-delà de la limite, texte trop près de la coupe), et son PDF est séparé via le profil de sortie ICC.
compare_pages.pyPlace côte à côte les pages de la source et celles de Postext, à partir du PDF du rendu ou de son dossier de JPEG ; avec --score, il mesure leur ressemblance, et avec --check le score échoue tant que les vérifications signalent encore un bloc posé sur un autre ; avec --watch DIR, à côté de postext build … --images DIR --watch, il réécrit la paire et le score d’une page chaque fois que cette page change
port_audit.pyCompare le PDF source et le PDF du portage attribut par attribut, en appariant les mots par leur contenu : espaces spéciales, italique (y compris un romain penché), gras, petites capitales, taille et graisse des puces, alignement et graisse des cellules de tableau, couleurs des folios, des titres courants et du texte. Il écrit un rapport JSON et un rapport Markdown avec un décompte par attribut et par page ; à lancer avant la livraison
composed_check.pyPages composées : round lit la version du moteur installé et indique quelle passe de portage il gère et quelles fonctions des pages composées lui manquent ; check lance postext check et postext html sur chaque édition et échoue sur les blocs qui débordent, les gabarits ou emplacements inconnus, les étiquettes qui ne tiennent pas sur leur ancre, le texte saisi dans la configuration et les blocs que le HTML lit dans un autre ordre que celui où le Markdown les remplit. Depuis postext 1.48, il échoue aussi quand un bloc passe sous un autre ou sort de sa boîte (frameCovered, frameOutsideArea) et termine par le nombre de chevauchements ; un chevauchement que la source imprime exprès est noté, avec sa raison, dans le composed-check.json du projet. Les réglages mal orthographiés et les valeurs que le moteur refuse (unknownConfigKey, unknownConfigValue) le font aussi échouer, et tous les autres avertissements sont affichés. --json-out FILE enregistre le résultat en gardant le rapport et le code de sortie, et preset_kit.py pack refuse d’empaqueter tant que la vérification enregistrée a échoué
postext_md.pyLe module d’appoint que les autres scripts importent pour écrire du texte dans le dialecte Markdown de Postext : marques en ligne en segments plats, caractères actifs échappés, et paragraphes qui se liraient comme une liste, un titre ou un délimiteur gardés comme texte

#L’installer

#N’importe quel agent (skills.sh)

La CLI skills détecte vos agents et installe le skill pour eux :

npx skills add drnachio/postext --skill postext-port

Choisissez les agents explicitement avec -a, et installez globalement (pour tous les projets) avec -g :

npx skills add drnachio/postext --skill postext-port -a codex -a claude-code -g

Le site publie le même skill, donc ceci fonctionne aussi :

npx skills add https://postext.dev

#Plugin Claude Code

Le dépôt Postext est aussi une marketplace de plugins Claude Code. Dans Claude Code :

/plugin marketplace add drnachio/postext
/plugin install postext@postext

Ou depuis un shell :

claude plugin marketplace add drnachio/postext
claude plugin install postext@postext

#Laisser l’agent l’installer

Vous pouvez demander à votre agent de le faire, par exemple : « Installez le skill de portage Postext (npx skills add drnachio/postext --skill postext-port) et utilisez-le pour porter ce PDF. » Les agents qui lisent https://postext.dev/llms.txt y trouvent cette page et la commande d’installation.

#Outils utilisés par les scripts

python3 -m pip install pymupdf pillow fonttools brotli numpy
brew install pandoc poppler
mkdir -p ~/.cache/postext-tools && cd ~/.cache/postext-tools && npm init -y && npm i postext postext-pdf postext-citeproc react @pdf-lib/fontkit @napi-rs/canvas

Pandoc est nécessaire pour les sources Word, PowerPoint, EPUB et HTML, poppler pour les images des pages de la source, et numpy pour comic_panels.py. Les paquets npm font tourner le moteur de rendu sans interface (Node 22.15 ou plus récent) ; @napi-rs/canvas est un canvas précompilé qui lui permet de dessiner les pages du livre directement en JPEG. Outils facultatifs : ocrmypdf pour les numérisations, ImageMagick, et veraPDF pour les vérifications PDF/UA.

mkdir -p ~/.local/bin && curl -fL -o ~/.local/bin/postext https://github.com/drnachio/postext/releases/latest/download/postext-macos-arm64 && chmod +x ~/.local/bin/postext

Choisissez le fichier de votre système (postext-macos-arm64, postext-macos-x64, postext-linux-x64, postext-linux-arm64, postext-linux-x64-musl, postext-windows-x64.exe) ; avec Node, npx postext-cli fonctionne aussi.

La boucle de travail s’exécute en ligne de commande, avec un seul exécutable autonome, sans rien à installer : l’agent garde le projet décompressé et laisse postext build --watch tourner sur les pages sur lesquelles il travaille : chaque modification apparaît ainsi en JPEG environ une seconde plus tard, même dans un long livre. Les paquets npm sont facultatifs : ils font tourner render.mjs, qui ajoute les vérifications supplémentaires du Sandbox. Les deux mettent le livre en page avec bodyText.shapingLanguage: 'host', quelle que soit sa configuration ; une ligne peut donc se couper à un autre mot que dans le Sandbox (voir Différences avec le Sandbox).

#L’utiliser

Placez les fichiers source dans votre dossier de travail et demandez le portage. Par exemple :

  • « Portez les chapitres 1 à 3 de manual.pdf vers Postext, en reproduisant sa mise en page sur deux colonnes, ses ouvertures de chapitre et ses encadrés. »
  • « Convertissez course.docx en livre Postext. Les styles “Nota” et “Actividad” sont des encadrés. »
  • « Transformez deck.pptx en support de cours Postext : les diapositives deviennent des sections, les notes de l’orateur deviennent le texte. »
  • « Nous avons le dossier InDesign (IDML + PDF d’impression) de ce manuel. Construisez le préréglage Postext du chapitre 1 en espagnol et en anglais. »

L’agent suit la méthode de travail :

  1. Cahier des charges. Il demande ce qu’il ne peut pas déduire : une reproduction fidèle ou une nouvelle maquette, un chapitre d’essai ou tout le livre, les langues, l’impression ou l’écran, et les droits sur le texte, les images et les polices.
  2. Inventaire et mesure. Il lit la source et rédige une fiche technique de faits mesurés : format, marges, colonnes, interlignage, rôles typographiques, palette, ouvertures, titres courants, familles d’encadrés et habitudes de placement. Il classe chaque page en texte courant ou en page composée (encadrés, étiquettes et cartes à des places fixes) ; avec Postext 1.35 ou plus récent, il regroupe les pages composées par type de page et monte chaque type à partir d’un gabarit : la mise en page reste identique et le texte peut quand même être corrigé et traduit ; avec une version plus ancienne, si plus d’un tiers des pages sont composées, il vous demande si vous voulez une mise en page identique ou un texte que vous pourrez corriger et traduire.
  3. Projet. Il crée la structure de my-book/ avec un générateur build_preset.py qui garde la fiche technique sous forme de constantes et produit preset.json.
  4. Contenu. Il extrait des brouillons de chapitres avec l’extracteur adapté, puis les met au propre en Markdown Postext : encadrés, styles de paragraphe, parties, attributs de titre pour les ouvertures, citations :ref, ressources de tableau et de figure.
  5. Vérification. Il passe le projet au linter et laisse postext build --watch tourner sur le projet décompressé : il modifie un chapitre ou un réglage, regarde le JPEG de la page, redessiné environ une seconde plus tard, et recommence jusqu’à ce que les sauts de page, les figures et les encadrés correspondent à la source page par page. À chaque étape importante, il lance toutes les vérifications (postext check et le linter). Le PDF est construit pour les vérifications d’impression, pas à chaque coup d’œil.
  6. Livraison. Il définit le papier, la reliure et les couvertures du livre pour la visionneuse Folio et empaquette my-book.postext.

Ouvrez le résultat dans le Sandbox : Livres → Nouveau → Ouvrir un fichier .postext…. À l’import, le Sandbox prend les chapitres et les textes de sa propre langue. Pour travailler sur un dossier de projets dans une copie locale de Postext, définissez POSTEXT_PRIVATE_PRESETS_DIR (voir Sandbox).

#Charger le résultat depuis du code

Le fichier livré n’est pas lié au Sandbox. Le paquet npm postext l’ouvre avec openBundle, met le livre en page avec buildBundle et le rend en canvas, en HTML ou en PDF (voir Paquets). Un portage peut donc alimenter directement un programme. Quand la sortie de ce programme demande des retouches, exportez-la de nouveau en fichier .postext avec createBundle, affinez-la dans le Sandbox et rechargez le fichier corrigé. Le render.mjs sans interface du skill accepte lui aussi un fichier .postext empaqueté en plus d’un dossier de projet.

#À quoi s’attendre

  • Les extracteurs produisent des brouillons ; l’agent les met au propre. Comptez une passe de relecture par chapitre, comparée aux pages de l’original. C’est de cette relecture que vient la qualité.
  • Le texte reste dans le Markdown. La configuration contient la maquette et chaque mot du livre se trouve dans les chapitres : une correction ou une traduction se fait donc dans le Markdown. Avec Postext 1.35 ou plus récent, les pages composées sont des gabarits de page dans la configuration, dont les blocs se remplissent avec le Markdown de chaque chapitre : un encadré s’allonge avec une traduction plus longue et repousse ceux du dessous, et depuis la 1.37 les noms d’une carte sont des étiquettes écrites dans le Markdown. Avec une version plus ancienne, elles sont montées avec des encadrés fixés à leur place, des images de page sans texte et des figures SVG dont les étiquettes restent du vrai texte. Le rapport indique laquelle des deux voies l’agent a suivie, et avec quelle version. Quand Postext ne sait pas exprimer quelque chose sans écrire du texte dans la configuration, l’agent s’arrête, rédige la lacune sous forme de brouillon de ticket et vous pose la question. Le skill ne modifie jamais le moteur pour l’adapter à un livre.
  • Un seul fichier pour toutes les langues. Une traduction est un jeu de chapitres dans le même fichier .postext, avec ses propres légendes et étiquettes de figures, vérifié avec postext check dans chaque langue.
  • Les droits relèvent de votre décision. L’agent demande avant de reproduire des images ou des polices dont les licences ne sont pas claires. Les polices sous licence sont marquées redistributable: false : les projets exportés ne les incluent donc pas.
  • La fidélité là où elle compte. L’objectif est d’obtenir la même grille, les mêmes caractères, les mêmes ouvertures, les mêmes encadrés, le même placement des figures et les mêmes sauts de page sur la plupart des pages (à une page près par chapitre), pas des coupures de lignes identiques.

#Où il se trouve

Le skill se trouve dans le dépôt, à l’emplacement plugins/postext/skills/postext-port. Il couvre tous les cas rencontrés en construisant les préréglages du Sandbox, publics et privés. Quand un portage tombe sur un cas qu’il ne couvre pas encore, ouvrez une issue ou une pull request qui améliore le skill, pour que le portage suivant en profite d’office.