Vers la lumière
Créer un EPUB et un PDF d'un seul texte : un livre remis à neuf
Mon livre numérique de 2018 corrigé ligne à ligne, puis recomposé d'un seul texte : un EPUB (livre pour liseuse) pour téléphone et liseuse, un PDF A5 pour l'écran, contrôlés avant chaque livraison.
- Avant
- Des doubles pages A3 illisibles sur téléphone, des notes loin de leur appel, deux textes en désaccord.
- Maintenant
- Un EPUB et un PDF A5 de 247 pages sortis du même texte, après 704 corrections suivies une à une.
Utile si vous avez un livre ou un long document à remettre à jour et à lire sur téléphone, liseuse et écran.
# stack
En 3 étapes
- Claude Code relève les fautes et les passages datés : chaque correction a un numéro, l'avant, l'après et la raison. Je valide par numéro.
- Des scripts appliquent mes corrections, posent la typographie française et sortent une version de révision où chaque changement se voit.
- Les mêmes scripts composent le PDF A5 et l'EPUB, puis contrôlent le tout : un seul contrôle en échec et rien n'est déposé.
A · Les corrections
01
Moi
je donne le livre de 2018
02
Le relevé des fautes
704 corrections numérotées
Claude Code
03
Moi, je valide
par numéro : tout oui sauf F074
04fait maison
Les corrections
appliquées, avec un journal
avecPython
B · Puis le livre
05fait maison
Les deux formats
PDF A5 et EPUB, un seul texte
avecPaged.jsChromeNode.jsqpdfEPUB 3
06fait maison
Les contrôles
un échec, rien n'est déposé
avecEPUBCheckPython
07
Le livre remis à neuf
EPUB et PDF, version suivante
À côté
fait maison
La version de révision
PDF annoté : je relis tout
avecPython
Un seul contrôle en échec, et rien n'est déposé.
- fait maison
- outil du marché, source ou résultat
- une personne
Pourquoi je l'ai fait
En 2018, j’ai publié « Vers la lumière », un livre numérique sur la conduite d’un projet photo personnel, en PDF de doubles pages A3 à l’italienne. Il a été critiqué : pas toujours très lisible. Sur téléphone, il fallait zoomer et se déplacer dans les deux sens, et les notes ne se cliquaient pas. Je n’avais jamais eu le temps, l’énergie ni le courage de le refaire : je n’ai pas de compétences en design. Ses versions Word et InDesign ne concordaient plus.
Ce que ça fait, concrètement
Je pars maintenant d’un seul texte, et des scripts en tirent deux fichiers :
- Un EPUB 3 dont le texte s’adapte à l’écran, pour le téléphone et la liseuse : un fichier par chapitre, les notes en fenêtre, les schémas en SVG.
- Un PDF au format A5, page à page, pour la tablette et l’ordinateur, avec les notes en bas de page.
Avant cela, 568 corrections de base (fautes, chiffres, liens, titres, images, typographie) et 136 corrections de fond (passages datés, redites, renvois) sont relevées, chacune avec son numéro, l’avant, l’après et la raison. Je valide par numéro, par exemple « tout oui sauf F074 ».
La version 2, livrée en octobre 2026, est en ligne : 247 pages A5, et un EPUB qui passe EPUBCheck, le validateur de référence du format, sans erreur ni avertissement.
Comment ça marche, en détail
Fabrication : 704 corrections numérotées, 5 schémas redessinés en SVG
Une seule commande rejoue tout le livre, du texte de départ jusqu’aux deux fichiers. Un script applique les corrections validées, un autre pose la typographie française. Les mêmes scripts produisent une version de révision, puis le PDF A5 et l’EPUB. Et des contrôles bloquent le dépôt des fichiers (leur livraison) au moindre défaut.
Une base sûre : le texte de l’InDesign corrigé, comparé mot à mot au fichier Word
Le texte de départ est celui de l’InDesign, corrigé à la main. Il est lu dans un de ses exports PDF et comparé mot à mot au fichier Word, dont un script reprend la mise en forme : gras, notes, liens, images. Les écarts entre les deux sont relevés un à un dans un tableau.
Les corrections et la typographie : appliquées par script, avec un journal de celles qui échouent
Un script applique les corrections validées au texte, et tient un journal de celles qu’il n’a pas pu appliquer, avec la raison. Un autre pose la typographie française : espaces insécables, guillemets, apostrophes.
La version de révision : un PDF où chaque changement se voit, comme le suivi des modifications de Word
Avant le livre final, les mêmes scripts produisent un PDF du livre entier où chaque changement se voit : barré rouge pour ce qui part, surligné jaune pour ce qui arrive, le numéro de la correction en marge. Je relis le livre tel qu’il sera.
Le PDF et l’EPUB : Paged.js, Chrome sans fenêtre en parallèle, qpdf, identifiants stables
Pour le PDF, le texte devient des pages HTML mises en page par Paged.js. Un seul Chrome sans fenêtre, piloté par un petit script Node.js, les imprime en PDF dans plusieurs onglets en parallèle, en gardant les numéros de page et de note continus d’un morceau à l’autre. L’outil qpdf assemble ensuite le tout. Un script Python construit l’EPUB à partir du même texte, avec les mêmes images, polices et couleurs. Ses identifiants restent stables d’une version à l’autre, pour qu’une liseuse reconnaisse le même livre.
Les schémas : cinq schémas PowerPoint redessinés en SVG, lisibles sans couleur
Ceux de 2018 étaient des formes PowerPoint, et deux d’entre eux ne se comprenaient que par la couleur, alors qu’une liseuse affiche en noir et blanc. Les cinq ont été redessinés en SVG, lisibles sans couleur. Le même fichier sert à l’EPUB et au PDF.
Les contrôles qui bloquent le dépôt : pages, tirets, renvois, images, marques de révision, EPUBCheck
Avant tout dépôt, le script vérifie : plus de 200 pages, aucun tiret cadratin, aucun renvoi de page non résolu, aucun avertissement du rendu, au moins 40 images, aucune marque de révision restée dans la version finale, et un EPUBCheck sans erreur ni avertissement. Un seul contrôle en échec, et rien n’est déposé. Chaque livraison prend le numéro de version suivant, sans jamais écraser la précédente.
Le rôle de chaque pièce
Les 7 étapes du schéma, une par une
- Moi J'ai écrit le livre. Je donne le fichier Word et l'export d'InDesign, dont le texte a été corrigé à la main.
- Le relevé des fautesClaude Code 568 corrections de base et 136 de fond, chacune avec son numéro, l'avant, l'après et la raison.
- Moi, je valide Je valide par numéro, par exemple « tout oui sauf F074 ».
- Les correctionsPythonfait maison Appliquent les corrections validées, tiennent un journal de celles qu'elles n'ont pas pu appliquer, et posent la typographie française.
- Les deux formatsPaged.js · Chrome · Node.js · qpdf · EPUB 3fait maison Pour le PDF : pages HTML mises en page par Paged.js, imprimées par un Chrome sans fenêtre piloté en Node.js, assemblées par qpdf. L'EPUB 3 sort du même texte par un script Python.
- Les contrôlesEPUBCheck · Pythonfait maison Plus de 200 pages, aucun tiret cadratin, aucun renvoi non résolu, au moins 40 images, aucune marque de révision, EPUBCheck sans erreur ni avertissement.
- Le livre remis à neuf Chaque livraison prend le numéro de version suivant, sans écraser la précédente. Version 2 : 247 pages A5 et un EPUB sans erreur.
# à côté
- La version de révisionPythonfait maison Un PDF du livre entier où chaque changement se voit : barré rouge ce qui part, surligné jaune ce qui arrive, le numéro en marge. Je relis le livre tel qu'il sera.
Ce que vous pouvez reprendre chez vous
Un livre ou un long document à remettre à jour se traite de la même façon : numérotez les corrections et validez-les par numéro, produisez une version de révision qui se lit comme le livre final, et posez des contrôles qui bloquent le dépôt. Paged.js, EPUBCheck et qpdf sont libres ; mes scripts, faits pour ce seul livre, restent dans mon dossier.
Ce que j'en retiens
Le déclic a été de séparer le texte de sa mise en page : chaque correction se décide une fois, et je rejoue le livre autant de fois qu’il faut. Et des centaines de corrections dans un tableau, c’est illisible ; à leur place dans le livre, elles se jugent sur pièce.
Images
-
Le même livre en EPUB, ouverture du chapitre « Introduction générale » à la largeur d'un téléphone : le texte s'adapte à l'écran.