Guides de migration · Ruby on Rails

Remplacer wkhtmltopdf par pdfkiln dans wicked_pdf

wicked_pdf rend les vues Rails en PDF avec wkhtmltopdf, installé en général par la gem wkhtmltopdf-binary. Retirez la gem, installez pdfkiln, faites pointer wicked_pdf dessus.

1. Installer pdfkiln

Sous Debian et Ubuntu, amd64 et arm64 : le dépôt APT signé installe /usr/bin/wkhtmltopdf, à la place du paquet wkhtmltox, et apporte les correctifs de Chromium avec apt upgrade.

curl -fsS https://apt.pdfkiln.org/pdfkiln-archive-keyring.asc | sudo tee /usr/share/keyrings/pdfkiln-archive-keyring.asc > /dev/null
printf 'Types: deb\nURIs: https://apt.pdfkiln.org\nSuites: stable\nComponents: main\nSigned-By: /usr/share/keyrings/pdfkiln-archive-keyring.asc\n' \
  | sudo tee /etc/apt/sources.list.d/pdfkiln.sources
sudo apt update && sudo apt install pdfkiln

Ailleurs : l’image Docker, les archives et le programme d’installation pour Windows.

2. Brancher wicked_pdf sur pdfkiln

# Gemfile: remove the gem that bundled wkhtmltopdf
# gem 'wkhtmltopdf-binary'

# config/initializers/wicked_pdf.rb
WickedPdf.config = { exe_path: '/usr/bin/wkhtmltopdf' }

3. Vérifier

wkhtmltopdf --version
# wkhtmltopdf 0.12.6 (with patched qt), pdfkiln 1.0.3, Chromium 156.0.8078.73

La réponse commence comme celle de wkhtmltopdf 0.12.6 : les bibliothèques qui lisent la version continuent de fonctionner.