Carnet Wiki

pdf_version

Version 5 — 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.

Headless ?

La plupart des outils de génération de HTML vers PDF depuis une page HTML 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 cela.

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

Wkhtmltopdf

pdf_version utilise un outil de commande en ligne appelé Wkhtmltopdf. Ce dernier prend 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 peut être bloquante pour la plupart des utilisateurs. Aussi voici quelques retours d’expérience.

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


À venir

<blockquote class="spip">

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

</blockquote>

Générer un PDF

Prérequis

Avoir activé le fichier htaccess.txt qui se trouve à la racine de votre site.
Pour cela vous devez renommer ce fichier comme suit : .htaccess

Méthodologie

Générer un PDF


Méthodologie -# avoir créé au moins un article et l’avoir publié.

  1. dans cet exemple on va utiliser le un squelette article.html et lui , 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 l’article # 1 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 <code>/pdf_version/pdf_version</code code >
/pdf_version/pdf_version
</
code >
Ce sont ces fichiers que vous pouvez surcharger.

Avantages et limites de la méthode Headless

Tralala
et tralalalou