Paper Engine : générer un vrai livre imprimable en pur code B5 avec Claude Code
Publier un livre technique sans s’arracher les cheveux sur InDesign : j’ai audité et déployé Paper Engine, le moteur open source qui transforme Claude Code en atelier typographique d’élite. Un canvas B5 rigide de 176x250 mm, des schémas vectoriels en pur SVG et une sortie PDF prête pour l’imprimeur.
⚡ L'essentiel en 30 secondes
Pourquoi la mise en page web (HTML/CSS) bat à plate couture les logiciels d’édition classiques ?
Créer un livre au format PDF professionnel avec Word ou Canva est un calvaire : un saut de ligne inopiné détruit la pagination et décale vos illustrations. Paper Engine règle ce problème en appliquant le principe du canvas rigide B5 (176 x 250 mm) gouverné par le même CSS à l'écran et au print. Vous rédigez vos concepts un par un (« un bloc = une page »), l’agent Claude Code trace les schémas explicatifs en pur SVG, et une commande Playwright compile la couverture, le sommaire dynamique, les séparateurs et l’index alphabétique en un PDF vectoriel prêt pour l'impression industrielle.
1. Le calvaire des logiciels d'édition traditionnels
Tout expert, consultant ou entrepreneur qui a déjà tenté de coucher son savoir-faire dans un manuel ou un livre blanc connaît cette tragédie moderne :
- L’enfer du texte glissant : vous modifiez une phrase à la page 12, et l'image de la page 13 se retrouve orpheline à la page 14, coupant un paragraphe en deux.
- L’illusion des outils WYSIWYG : sur Canva ou Google Docs, ce qui est affiché sur votre écran 16:9 n'a strictement rien à voir avec le rendu physique une fois envoyé à un imprimeur professionnel.
- La dette de maintenance : maintenir un PDF gratuit pour la capture de leads et une version payante de 100 pages oblige à gérer deux fichiers séparés qui deviennent obsolètes en quelques mois.
Créé par l'ingénieur Hasan Aboul Hasan pour publier son propre ouvrage de référence Vibe Engineering Blocks, Paper Engine traite le livre non pas comme un document bureautique, mais comme une chaîne de compilation logicielle.
2. Le contrat du Canvas B5 : 176 x 250 mm de rigueur absolue
Au cœur de Paper Engine réside une décision architecturale fondamentale : la page n'est pas fluide, c'est une boîte rigide aux dimensions standardisées B5 (176 mm de large sur 250 mm de haut).
Le moteur bannit expressément les requêtes @media print qui altèrent les polices ou les marges. Ce que vous observez dans votre navigateur web est strictement identique au micron près au fichier PDF de sortie.
3. L'anatomie d'une page : les 7 blocs immuables
Chaque page du livre (un « bloc » dans la terminologie du moteur) est encapsulée dans une balise sémantique <section class="sheet bb"> respectant 7 composants immuables :
- 1. L'onglet d'accentuation (Tab) : un marqueur coloré discret rappelant l'univers de l'ouvrage.
- 2. Eyebrow & Pillule thématique : le nom de la série et la catégorie exacte du sujet.
- 3. Titre & Sous-titre explicite : la formulation concise du concept et sa vulgarisation immédiate.
- 4. Le bandeau visuel calibré : soit un schéma SVG si le sujet est logique/mécanique, soit une photographie si le sujet est physique. Les deux occupent exactement la même hauteur.
- 5. Le corps explicatif (Explainer) : 2 à 3 paragraphes denses avec une phrase conclusive percutante.
- 6. La boîte d'action (Action Box) : l'exercice pratique ou la commande immédiate que le lecteur doit appliquer.
- 7. Le pied de page dynamique : titre de la partie, nom de marque et pagination recalculée au millimètre.
4. Pourquoi les schémas doivent être écrits en code SVG
À l'ère de Midjourney, la tentation est grande de demander à une IA de générer une image pour illustrer un concept d'ingénierie. C'est la pire erreur possible : les générateurs d'images bavent sur la typographie, tracent des flèches sans queue ni tête et ne peuvent pas être corrigés sans tout relancer.
Dans Paper Engine, chaque schéma est un bloc SVG pur codé en ligne par l'agent IA :
- Modifiable instantanément : corriger une étiquette ou renommer un composant prend 2 secondes dans le fichier HTML.
- Fidélité vectorielle infinie : pas de pixels flous à l'impression ; le trait reste d'une netteté absolue en 300 et 600 DPI.
- Grammaire de couleurs cohérente : l'indigo pour le sujet enseigné, le vert émeraude pour le résultat optimal, le rouge pour l'erreur fatale et l'ambre pour l'élément à protéger.
5. La boucle de vérification : check, shot et lecture humaine
La production d'un livre d'ingénierie suit une boucle stricte : Rédiger ➔ Compiler ➔ Mesurer ➔ Inspecter ➔ Exporter.
make a block on <sujet> ──▶ Claude Code rédige la page HTML et trace le SVG
│
▼
npm run check ──▶ Playwright mesure chaque page : exigence impérative de 0 mm !
│
▼
npm run shot ──▶ Rendu de chaque page en capture PNG haute définition
│
▼
Inspection humaine ──▶ Vous ouvrez les PNG : le schéma raconte-t-il la vérité ?
│
▼
npm run export ──▶ Compilation finale du PDF prêt pour l'imprimeur
6. Crash-Test : Que faire en cas de débordement de page ?
La tentation est grande de tricher avec les feuilles de style lorsque du texte déborde de la boîte B5.
Si la commande 'npm run check' renvoie un débordement de +4 mm sur une page, quelle est la SEULE action autorisée par le moteur ?
Vous avez rédigé une explication dense et la commande check vous indique que la hauteur dépasse le format B5.
7. Démarrer son propre livre en 4 commandes
Pour installer l'atelier de publication sur votre machine avec Node.js 18+ :
# 1. Cloner le dépôt officiel open-source
git clone https://github.com/hassancs91/paper-engine
cd paper-engine
# 2. Installer les dépendances et le navigateur de mesure Playwright
npm install
npx playwright install chromium
# 3. Compiler et vérifier le livre exemple (10 pages)
npm run build -- books/showcase
npm run check -- books/showcase/book.html
# 4. Exporter le PDF d'impression complet
npm run export -- books/showcase/book.htmlLes 4 étapes pour créer votre premier ouvrage technique
8. Les éditions multiples : d'un fichier source à 3 formats business
L’un des coups de génie de Paper Engine est la gestion native des éditions dans book.json. Vous écrivez vos pages une seule fois, et vous pouvez générer :
Une sélection de vos 10 meilleurs concepts exportée en 5 secondes pour offrir à vos prospects contre leur email. Table des matières et pagination renumérotées automatiquement.
L’intégralité de votre méthodologie avec intercalaires de parties, index alphabétique exhaustif et couverture complète, vendu en PDF ou imprimé à la demande.
Chaque page B5 peut être exportée en PNG haute résolution pour être publiée telle quelle sur LinkedIn ou Twitter comme une infographie d'élite.
9. L’avis Nümtema : l’autorité de marque par le livre d’ingénieur
Dans un monde saturé de publications LinkedIn éphémères et de vidéos de 30 secondes, le livre physique reste le sommet absolu de l'autorité intellectuelle et commerciale. Un prospect qui reçoit un livre de 60 pages relié avec un graphisme irréprochable ne vous perçoit plus comme un simple prestataire, mais comme la référence incontestable de votre secteur.
Paper Engine libère les fondateurs et directeurs techniques de la complexité de l'édition. Chez Nümtema, nous exploitons ces architectures de publication par code pour aider nos clients à transformer leur propriété intellectuelle en actifs digitaux pérennes et hautement rentables.
Une question technique sur cet article ?
Interrogez Nüm, notre assistant IA, pour clarifier un point d'architecture ou estimer la faisabilité sur votre stack.
10. Sources officielles et documentation vérifiée
Vérifié sur le dépôt officiel hassancs91/paper-engine sous licence libre MIT. Liens d’accès :
10. Questions fréquentes
Pourquoi utiliser Paper Engine plutôt qu’InDesign, Canva ou Word ?+
InDesign et Word souffrent du syndrome du « texte qui glisse » : rajouter un paragraphe décale tout le livre et casse la mise en page. Paper Engine applique une règle d’ingénierie stricte : un concept = une page B5 rigide (176 x 250 mm). Le même CSS gouverne l’écran et l’impression. Aucun décalage n’est possible.
Pourquoi les diagrammes sont-ils écrits en pur SVG plutôt que générés par une IA d’image (Midjourney / DALL-E) ?+
Les modèles d’images IA inventent du texte illisible, déforment les flèches et créent des pixels flous à l’impression. Dans Paper Engine, chaque diagramme est du code SVG pur rédigé par l’agent IA : il s’imprime en haute résolution vectorielle à 300+ DPI, ne coûte rien en calcul et se modifie au mot près.
Comment fonctionne la commande de contrôle technique "npm run check" ?+
Le script Playwright mesure le dépassement vertical de chaque page au millimètre près dans un navigateur headless Chromium. Chaque page doit impérativement afficher 0 mm de débordement. Si un texte est trop long, la règle exige de couper des mots, jamais de rétrécir le dessin.
Est-il possible de générer plusieurs éditions d’un même livre ?+
Oui. Le fichier book.json gère des éditions configurables (ex: édition gratuite de 10 pages pour capturer des leads, et édition complète payante de 50 pages). Le moteur recompile le sommaire dynamique, la table des matières et la pagination sans jamais dupliquer le contenu.
Quel est le matériel requis pour faire tourner Paper Engine ?+
Node.js 18+ et un terminal. Le navigateur headless Chromium est installé via Playwright (npx playwright install chromium). Aucune dépendance Python lourde n’est nécessaire pour l’édition de base.