Carnet Wiki

pdf_version

Version 3 — 3 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 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 faire cela déjà très bien.

D’où l’idée que certains on eu d’utiliser le moteur de rendu navigateur Web de ces derniers pour faire le travail.

Wkhtmltopdf

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 le moteur de rendu WebKit, le moteur de rendu du navigateur Safari.

Installation et configuration

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

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

Cette partie est peut être la plus bloquante de ce plugin, aussi voici quelques conseils.

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

Générer un PDF

Méthodologie
avoir créé au moins un article et l’avoir publié.
dans un squelette article.html , ajouter

Générer un PDF


Vous aller utiliser 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