Skip to content
Floskool

Chapter 6 · Chapitre 6 · Exporter en PDF et contrôler la qualité

6.4 Dépannage : les problèmes d'export courants

Free lesson 9 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Voici les problèmes que tu rencontreras presque forcément, et comment les régler.

La couverture sort blanche ou les encadrés n'ont plus de fond Les couleurs de fond ne sont pas imprimées par défaut. Ajoute dans le CSS : print-color-adjust: exact; (et -webkit-print-color-adjust: exact;). En impression manuelle, coche « Graphiques d'arrière-plan ».

Une date et un chemin de fichier apparaissent en haut et en bas des pages Ce sont les en-têtes de Chrome. En ligne de commande, ajoute --no-pdf-header-footer. À la main, décoche « En-têtes et pieds de page ».

La police n'est pas la bonne Chrome n'a pas eu le temps de la télécharger, ou le nom est mal écrit. Ajoute --virtual-time-budget=8000 à la commande, vérifie le lien Google Fonts, ou installe la police sur ton ordinateur. Le script de contrôle (leçon 6.3) te dit si elle est chargée.

Une page se coupe au mauvais endroit, ou une page blanche apparaît Vérifie que chaque page a bien une hauteur fixe de 297 mm, overflow: hidden et page-break-after: always, sauf la dernière (page-break-after: auto). Une page blanche en fin de document vient presque toujours d'un saut de page sur la dernière section.

Le format n'est pas A4 Ajoute @page { size: A4; margin: 0; }. Pour un format lettre américain, remplace A4 par letter, mais adapte aussi les dimensions des pages.

Une image n'apparaît pas Le chemin est probablement faux. Utilise des chemins relatifs au fichier HTML (images/photo.jpg) et garde les images dans le dossier du guide.

Le PDF est très lourd Ce sont presque toujours les images. Demande à Claude Code de les redimensionner à la taille réellement affichée avant l'export.

Prompt de dépannage universel

Le PDF exporté présente ce problème : [décris ce que tu vois, page par page].
Trouve la cause dans guide.html, explique-la en une phrase simple,
corrige-la, réexporte le PDF et rends à nouveau les pages concernées
en image pour vérifier.