Carnet Wiki

pdf_version

Version 4 — 2 weeks ago Peetdu

Ce plugin permet de générer un PDF à partir d’une page HTML/CSS Sa spécificité est d’utiliser un moteur de rendu de navigateur Web pour faire le travail, ce qui , comme on va le voir dans cette documentation , présente de nombreux avantages et quelques limites .

Headless ?

La plupart des outils de génération HTML vers PDF utilisent des librairies reposant sur des langages comme PHP, Javascript, Python, etc.

On pourrait dire que ces librairies “réinventent la roue” puisque nos navigateurs savent déjà faire celadéjà très bien .

D’où l’idée d’utiliser le moteur de rendu d’un navigateur Web pour faire le travail.

Wkhtmltopdf

pdf_version Pdf_version utilise un outil de commande en ligne appelé Wkhtmltopdf. Ce dernier prend donc un fichier HTML avec sa feuille de style CSS et renvoi la page PDF correspondante. Et il fait tout cela en utilisant WebKit, le moteur de rendu du navigateur Safari.

Installation et configuration

Après avoir installé le plugin, rendez-vous directement sur sa page de configuration pour choisir par quelle méthode vous voulez faire appel à wkhtmltopdf

  1. par exécution sur le serveur
  2. par une API http

Cette étape partie est peut être la plus bloquante pour la plupart des utilisateurs de ce plugin , aussi voici quelques conseils . Aussi voici quelques retours d’expérience.

<blockquote class="spip">

N’hésitez pas à faire part de votre expérience à ce sujet dans le forum de cet article. Nous ne manquerons pas de les intégrer dans cette doc.

</blockquote>

Sur Mac

Sur Mac -* aller sur https://wkhtmltopdf.org/downloads.html

  • télécharger l’installeur pour MacOS
  • installer Wkhtmltopdf
  • rendez-vous directement dans la page de configuration
  • Choissir la méthode de génération “exec(’wkhtmltopdf’) sur le serveur”
  • Dans le champ “Chemin d’accès au binaire wkhtmltopdf” tapper ’wkhtmltopdf
  • Et c’est bon

Sur PC

Générer un PDF

Méthodologie

  1. avoir créé au moins un article et l’avoir publié.
    -# dans un squelette article.html, ajouter la balise #URL_PDF_VERSION comme ceci
<a href="#URL_PDF_VERSION{article,1}">Voir mon PDF</a>

Rendez-vous sur la page publique de votre article et cliquez sur le lien “Voir mon PDF”
Et voilààààà

Pour aller plus loin

La balise #URL_PDF_VERSION va chercher les squelettes dans le répertoire

/pdf_version/pdf_version

Ce sont ces fichiers que vous pouvez surcharger.

Avantages et limites de la méthode Headless

Tralala
et tralalalou