Linux上的wkhtmltox安装：快速解决问题 (wkhtmltox linux安装)

在Linux操作系统中安装wkhtmltox，是网页转PDF、JPEG、PNG等格式的必装软件之一。然而，由于系统环境和库的不同，安装过程中可能会遇到各种问题，导致安装失败或无法正确使用。本文将针对常见问题，介绍Linux上的wkhtmltox安装方法及解决方案，帮助读者快速解决相关问题。

一、先决条件

在安装之前，需要准备以下环境：

– Linux操作系统（推荐Ubuntu或 CentOS）

– CMake 2.8以上版本

– Qt 4.8或Qt 5.2以上版本

– libc、libssl以及其他相关库文件

二、下载安装包

wkhtmltox的开源代码托管在Github上，可以通过以下命令下载源码：

$ git clone git://github.com/wkhtmltopdf/wkhtmltopdf.git

也可以从官网下载已编译好的二进制包：

$ wget https://downloads.wkhtmltopdf.org/0.12/0.12.5/wkhtmltox-0.12.5_linux-generic-amd64.tar.xz

$ tar -xvf wkhtmltox-0.12.5_linux-generic-amd64.tar.xz

三、编译安装

1.使用CMake

进入解压后的源码目录，并执行以下命令：

$ mkdir build

$ cd build

$ cmake ..

用CMake生成Makefile文件，接着使用make命令编译并安装：

$ make -j$(nproc)

$ sudo make install

这种方法编译比较慢，需要下载编译依赖的库，但可以完全自定义编译选项，适用于高级使用者。

2.使用静态库

如果不需要自定义编译选项，也可以选择使用静态库来编译安装。首先进入源码目录，执行以下命令：

$ qmake

$ make -j$(nproc)

并将生成的可执行文件移动到/usr/bin下：

$ sudo cp wkhtmltoimage /usr/bin

$ sudo cp wkhtmltopdf /usr/bin

静态库的编译速度更快，不需要下载依赖库，但相应的编译选项不能更改。

四、解决常见问题

1. 编译过程中提示CMake版本太低

升级CMake至2.8或以上版本：

$ sudo apt-get install cmake

2. 缺少Qt库文件

使用以下命令安装Qt库文件，版本根据实际情况选择：

Ubuntu：

$ sudo apt-get install libqt5webkit5-dev

CentOS：

$ sudo yum install qt5-qtwebkit-devel

3. 编译过程中缺少依赖库

Ubuntu：

$ sudo apt-get install libssl-dev libxrender-dev libxext-dev libfontconfig1-dev libfreetype6-dev libx11-dev

CentOS：

$ sudo yum install openssl-devel libXrender-devel libXext-devel fontconfig-devel freetype-devel libX11-devel

4. 无法正确生成PDF文件

如果网页中包含CSS或JavaScript等动态元素，需要将它们也下载下来并进行转换：

$ wkhtmltopdf http://example.com –javascript-delay 2023 –enable-javascript –no-stop-slow-scripts –load-error-handling ignore example.pdf

如果需要等待页面加载完成后再开始转换，可以加入–javascript-delay参数，并增大等待时间以确保页面加载完毕。

五、

以上就是Linux上的wkhtmltox安装方法及常见问题的解决方案。当然，不同的系统环境和实际需求会导致安装过程中出现不同的问题，需要逐一排查解决。希望本文能够给读者提供一些帮助和参考，顺利完成wkhtmltox的安装和使用。