Chapitre 6 · Chapitre 6 · Exporter en PDF et contrôler la qualité
6.4 Dépannage : les problèmes d'export courants
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementVoici 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.