WKHTMLTOPDF

📄 Description

wkhtmltopdf est un outil en ligne de commande permettant de convertir des fichiers HTML en fichiers PDF, avec prise en charge des headers, footers et styles CSS.

⚙️ Syntaxe de base

wkhtmltopdf [options] [fichier.HTML] [fichier.PDF]

• Pas d’espaces dans les noms de fichiers.
• Le premier fichier est la source HTML, le second est le PDF généré.

🧩 Options principales

📁 Accès fichiers locaux

--enable-local-file-access

Autorise l’accès aux fichiers locaux (requis pour inclure un header/footer HTML local).

🔝 Header (en-tête)

• --header-html fichier_header.html : ajoute un header HTML personnalisé.
• --header-left, --header-center, --header-right : texte simple dans l’en-tête.

🔚 Footer (pied de page)

• --footer-html fichier_footer.html : ajoute un footer HTML personnalisé.
• --footer-left, --footer-center, --footer-right : texte simple dans le footer (ex: --footer-center "[page] de [toPage]").

📏 Espacements

• --header-spacing 5 : espace entre le header et le contenu.
• --footer-spacing 5 : espace entre le footer et le contenu.

🧪 Exemple complet

wkhtmltopdf --enable-local-file-access \
  --header-html header.html \
  --footer-html footer.html \
  --header-spacing 5 \
  --footer-spacing 5 \
  page_source.html sortie.pdf
  

💡 Bonnes pratiques

• Tester vos fichiers HTML dans un navigateur avant conversion pour vérifier le rendu.
• Préférer des chemins relatifs ou absolus valides avec --enable-local-file-access.