wkhtmltopdf

auto generated documentation

Beispielaufruf führt einen Zoom der Ausgabebreite 540px auf Seitenbreite A4. Da eine Vergrößerung eintritt, sollte die Schriftgröße für normalen Text reduziert werden (z.B. von 10 auf 8pt). Aufzählungszeichen müssten entsprechen angepasst werden.

Aktuell ist 540px für die Druckausgabe 540px zu schmal.

Standardversion für Ubuntu 14.04 ist wkhtmltopdf 0.9.9. Die Version funktioniert. Die Installation ist nicht ganz einfach, siehe:

http://fedir.github.io/web/blog/2013/09/25/install-wkhtmltopdf-on-ubuntu/

http://www.odoo.yenthevg.com/install-wkhtmltopdf-on-ubuntu/

Installation auf Debian 7

Identisch zu Ubuntu wird die Version 0.9.9 geliefert und installiert:

http://fedir.github.io/web/blog/2013/09/25/install-wkhtmltopdf-on-ubuntu/

sudo apt-get install wkhtmltopdf

sudo apt-get install xvfb

xvfb-run --server-args="-screen 0, 1024x768x24" /usr/bin/wkhtmltopdf http://www.google.com output.pdf

echo 'xvfb-run --server-args="-screen 0, 1024x768x24" /usr/bin/wkhtmltopdf $*' > /usr/bin/wkhtmltopdf.sh

wenn das nicht funktuioniert, dann mit vi bearbeiten

sudo chmod a+rx /usr/bin/wkhtmltopdf.sh

sudo ln -s /usr/bin/wkhtmltopdf.sh /usr/local/bin/wkhtmltopdf

wkhtmltopdf http://www.google.com output.pdf

http://.../output.pdf

Statische Version

Die Ubuntu Version ist funktionseingeschränkt. z.B. hat --zoom garnicht funktioniert in 0.9.9

Man soll dazu eine statische Version verwenden, verschiedene Anleitungen:

http://manpages.ubuntu.com/manpages/raring/man1/wkhtmltopdf.1.html

http://blog.tcs.de/install-wkhtmltopdf-on-ubuntu-server

https://gist.github.com/pmdarrow/3427827

http://natepinchot.com/2014/01/31/building-static-wkhtmltopdf/ 

Debian 9

Über Linux-Repository wird wkhtmltopdf 0.12.3.2 bereitgestellt. Funktion wurde noch nicht getestet. Ob separate Installation 0.12.4 wie unten beschrieben noch notwendig, ist daher noch unbekannt. Versionsausgabe zeigt (with patched qt) nicht an:

# wkhtmltopdf --version
wkhtmltopdf 0.12.3.2

Debian 7

Hier mit funktionieren alle aktuellen Features (--zoom). War sofort funktionsfähig. Ablauf mit root-Rechten (Verwendung sudo):

wget http://download.gna.org/wkhtmltopdf/0.12/0.12.2.1/wkhtmltox-0.12.2.1_linux-wheezy-amd64.deb
sudo dpkg -i wkhtmltox-0.12.2.1_linux-wheezy-amd64.deb
sudo apt-get -f install
wkhtmltopdf --version

Ubuntu 14

als root:

wget http://download.gna.org/wkhtmltopdf/0.12/0.12.2.1/wkhtmltox-0.12.2.1_linux-trusty-amd64.deb 
dpkg -i wkhtmltox-0.12.2.1_linux-wheezy-amd64.deb
apt-get install xfonts-75dpi
apt-get -f install
wkhtmltopdf --version

siehe:

http://wkhtmltopdf.org/downloads.html

http://askubuntu.com/questions/556667/how-to-install-wkhtmltopdf-0-12-1-on-ubuntu-server 

http://sourceforge.net/projects/wkhtmltopdf/files/0.12.2.1/

0.12.4

Im Github findet man aktuelle Binaries, die nur kopiert werden müssen. wkhtmltox-0.12.4_linux-generic-amd64.tar.xz funktioniert unter Ubuntu 14 und Debian 7/9

https://github.com/wkhtmltopdf/wkhtmltopdf/releases

https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz 

How to Install:

https://gist.github.com/isogram/1b39fa91f34e35e66c84fe066cc37577

# wget http://download.gna.org/wkhtmltopdf/0.12/0.12.3/wkhtmltox-0.12.3_linux-generic-amd64.tar.xz
wget https://downloads.wkhtmltopdf.org/0.12/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
tar -xvf wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
cd wkhtmltox/bin/

Version prüfen

# .../wkhtmltox/bin/wkhtmltopdf --version
wkhtmltopdf 0.12.4 (with patched qt)

Blockierungsproblem

Die Version 0.12.2.1 blockiert zufällig (etwa 1 von 10) im Apache-Kontext (im error.log Fehler QPainter). Das Problem wurde angeblich behoben:

https://github.com/wkhtmltopdf/wkhtmltopdf/commit/9fa4695ace411ea6e27e68c790c62f1e63646017

In Version 0.12.4 tritt die Blockierung aber auch noch auf, jedoch wesentlich seltener (1 von 100, äbhängig von Größe des Dokumentes). Bei abgesetztem Webserver (wkhtmltopdf und Webserver auf verschiedenen Maschinen) trat das Problem bisher noch nicht auf (auch älterer Versionen). Wenn man mehrere Server zur Verfügung hat, kann man den wkhtmltopdf-Aufruf auf einen anderen Server umleiten.

Um Blockierungen zu lösen, müsste die Prozessausführung überwacht werden und nach einem Timeout ein kill ausgeführt werden:

pkill -f wkhtmltopdf

Installation:

sudo apt-get install pdftk

Das pdftk erlaubt u.a. das Zusammensetzen von PDF-Dateien. Dies wird CELLstudio durch Erweiterung CmsPageToPdf verwendet, um Handbücher mit Inhaltsverzeichnis zu erstellen:

pdftk in1.pdf in2.pdf cat output out1.pdf

pdftk toc228.pdf book228.pdf cat output tocbook228.pdf

Steuerung des Umbruchverhaltens

page-break-inside: avoid !important;

siehe cms/extenions/CmsPageToPdfContent.asp