thomas@hammoudi:~/dev$

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.

en service · Version 2 livrée en octobre 2026 : 247 pages, EPUB sans erreur · mis à jour en

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

  1. 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.
  2. Des scripts appliquent mes corrections, posent la typographie française et sortent une version de révision où chaque changement se voit.
  3. 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é.
Le PDF A5 de « Vers la lumière » : la couverture, puis deux pages de texte avec leurs notes en bas de page.
Le PDF A5 de « Vers la lumière » : la couverture, puis deux pages de texte avec leurs notes en bas de page.
$ livre-epub-pdf --schema7 étapes · 4 faits maison

A · Les corrections

01

Moi

je donne le livre de 2018

les deux textes

02

Le relevé des fautes

704 corrections numérotées

Claude Code

la liste

03

Moi, je valide

par numéro : tout oui sauf F074

corrections oui

04fait maison

Les corrections

appliquées, avec un journal

avecPython

B · Puis le livre

texte corrigé
texte corrigé

05fait maison

Les deux formats

PDF A5 et EPUB, un seul texte

avecPaged.jsChromeNode.jsqpdfEPUB 3

EPUB et PDF

06fait maison

Les contrôles

un échec, rien n'est déposé

avecEPUBCheckPython

tout est bon

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

le détail, étape par étape

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
  1. Moi J'ai écrit le livre. Je donne le fichier Word et l'export d'InDesign, dont le texte a été corrigé à la main.
  2. 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.
  3. Moi, je valide Je valide par numéro, par exemple « tout oui sauf F074 ».
  4. 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.
  5. 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.
  6. 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.
  7. 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.
    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.

tous les projets