网页转化成pdf,网页转换图片,wkhtmltopdf,wkhtmltoimage使用小结

简介: 如果必须是异步接口,让后台调用的时候,在命令行里面加上延时--javascript-delay 10000,默认是200ms,意思命令行访问url的时候,延时10000毫秒生成pdf或者图片,这样也能解决问题,但是请求时间过长。

1、简介:


wkhtmltopdf,wkhtmltoimage是开源命令行工具,使用Qt WebKit渲染引擎将HTML呈现为PDF和各种图像格式。


官网:


wkhtmltopdf


github:


Issues · wkhtmltopdf/wkhtmltopdf · GitHub


2、前端调试的时候踩过的坑


1、跟后台数据调试的时候,最好是同步页面(数据展示同步渲染出来结果),调用后台方法的时候,后台是执行了命令,直接把当前网页路径转成pdf或者图片,如果是异步请求,数据没有渲染完成,生成的pdf或者图片不完整;

wkhtmltopdf.exe http://www.badiu.com D:\test.pdf

2、如果必须是异步接口,让后台调用的时候,在命令行里面加上延时--javascript-delay 10000,默认是200ms,意思命令行访问url的时候,延时10000毫秒生成pdf或者图片,这样也能解决问题,但是请求时间过长。

wkhtmltopdf.exe --javascript-delay 10000 https://www.baidu.com D:\test.pdf

3、接上条,如果必须是异步请求接口,但是异步请求设置延时时间也不太好,一是请求时间过长体验不好,二是接口请求时间可能会超过你设置的延时时间,那么另外一种思路:


页面异步请求获取数据

在异步数据渲染完毕以后,获取需要生成pdf的网页内容,dom结构,通过js获取,包括dom结构以及样式设置。

调用后台接口,把获取的内容转码,转成base64等传递给后台

前端再另外创建一个页面,同步过去内容,这个时候后台需要把第三步从前端获取的内容,通过同步是形式传递给前端。

后台生成pdf命令的时候,直接写第四步的网页地址。

4、转成pdf或者网页的时候,不支持css3部分样式;不支持新的自定义html标签,例如定义的组件,template等


3、前端快速调试测试工具


前端样式测试的时候,不一定每次都需要调用后台接口,问后台要下java执行的 命令行,自己下载个工具测试。


官网下载工具,地址wkhtmltopdf

下载完成以后安装,记住安装目录

进入安装的bin目录下面,执行命令

进入自定义的安装生成目录,查看pdf或者图片是否跟网页一致

注意生成pdf或者images的时候,生成的后缀一定要写对。

cb0c5c2dbfac997dc970a086e952dc1.png

wkhtmltopdf.exe --javascript-delay 10000 https://www.baidu.com D:\test.pdf
wkhtmltopdf.exe  https://www.baidu.com D:\test.pdf
wkhtmltoimage.exe  https://www.baidu.com D:\test.jpg

4、常用命令


下面命令行,摘自官网

      --no-collat​​e打印多个时不进行整理副本
      --cookie-jar <path>读取和写入cookie,提供的cookie jar文件
      --copies <number>要打印到pdf中的份数,文件(默认1)
  -d, -  dpi <dpi>显式更改dpi(这没有对基于X11的系统的影响)(默认为96)
  -H, -  extended-help显示更广泛的帮助,详细说明不太常见的命令开关
  -g, -  grayscale PDF将以灰度生成
  -h, -  help显示帮助
      --htmldoc输出程序html帮助
      --image-dpi <integer>当嵌入图像时将它们缩小到
                                      这个dpi(默认为600)
      --image-quality <integer>当jpeg压缩图像时使用它
                                      质量(默认94)
      --license输出许可证信息并退出
      --log-level <level>将日志级别设置为:none,error,warn或
                                      信息(默认信息)
  -l, -  lowquality生成较低质量的pdf / ps。有用的
                                      缩小结果文档空间
      --manpage输出程序手册页
  -B, -  margin-bottom <unitreal>设置页面底部边距
  -L, -  margin-left <unitreal>设置页面左边距(默认为10mm)
  -R, -  margin-right <unitreal>设置页面右边距(默认为10mm)
  -T, -  margin-top <unitreal>设置页面上边距
  -O, - 方向<orientation>将方向设置为横向或纵向
                                      (默认人像)
      --page-height <unitreal>页面高度
  -s, -  page-size <尺寸>将纸张尺寸设置为:A4,Letter等
                                      (默认A4)
      --page-width <unitreal>页面宽度
      --no-pdf-compression不要在pdf上使用无损压缩
                                      对象
  -q, -  quiet更加冗长,为倒退而维护
                                      兼容性; 与使用--log-level相同
                                      没有
      --read-args-from-stdin从stdin读取命令行参数
      --readme输出程序自述文件
      --title <text>生成的pdf文件的标题(如果没有,则使用第一个文档的标题指定)
      --use-xserver使用X服务器(一些插件和其他插件)没有X11可能无法正常工作
  -V, -  version输出版本信息并退出
大纲选项:
      --dump-default-toc-xsl将默认的TOC xsl样式表转储到标准输出
      --dump-outline <file>将大纲转储到文件中
      --outline将大纲放入pdf(默认)
      --no-outline不要在pdf中加入大纲
      --outline-depth <level>设置轮廓的深度(默认为4)
页面选项:
      --allow <path>允许指定的文件要加载的文件夹(可重复)
      --background打印背景(默认)
      --no-background不打印背景
      --bypass-proxy-for <value>绕过主机代理(可重复)
      --cache-dir <path> Web缓存目录
      --checkbox-checked-svg <path>选中渲染时使用此SVG文件
                                      复选框
      --checkbox-svg <path>在未选中呈现时使用此SVG文件复选框
      --cookie <name> <value>设置一个额外的cookie(可重复),值应该是url编码的。
      --custom-header <name> <value>设置一个额外的HTTP头(可重复)
      --custom-header-propagation添加指定的HTTP头- 每个资源请求的自定义标头。
      --no-custom-header-propagation不添加指定的HTTP头- 每个资源请求的自定义标头。
      --debug -javascript显示javascript调试输出
      --no-debug-javascript不显示javascript调试输出(默认)
      --default-header添加一个默认标题,其名称为
                                      页面左侧,页码到
                                      右边,这是:
                                      --header左= '[网页]'
                                      --header-right ='[page] / [toPage]' -  top 2cm
                                      --header线
      --encoding <encoding>设置输入的默认文本编码
      --disable-external-links不要链接到远程网页
      --enable-external-links建立到远程网页的链接(默认)
      --disable-forms不要将HTML表单字段转换为pdf格式
                                      字段(默认)
      --enable-forms将HTML表单字段转换为pdf表单字段
      --images加载或打印图像(默认)
      --no-images不加载或打印图像
      --disable-internal-links不要建立本地链接
      --enable-internal-links制作本地链接(默认)
  -n, -  disable-javascript不允许网页运行javascript
      --enable-javascript允许网页运行javascript
                                      (默认)
      --javascript-delay <msec>等待几毫秒的javascript
                                      完成(默认200)
      --keep-relative-links将相对外部链接保持为相对
                                      外部链接
      --load-error-handling <handler>指定如何处理失败的页面
                                      load:abort,ignore或skip(默认值
                                      中止)
      --load-media-error-handling <handler>指定如何处理媒体文件
                                      无法加载:中止,忽略或跳过
                                      (默认忽略)
      --disable-local-file-access不允许转换本地文件
                                      读取其他本地文件,除非
                                      明确允许使用--allow
      --enable-local-file-access允许将本地文件转换为read
                                      在其他本地文件中。(默认)
      --minimum-font-size <int>最小字体大小
      --exclude-from-outline不要在表格中包含该页面
                                      内容和大纲
      --include-in-outline在目录中包含该页面
                                      和轮廓(默认)
      --page-offset <offset>设置起始页码(默认为0)
      --password <密码> HTTP验证密码
      --disable-plugins禁用已安装的插件(默认)
      --enable-plugins启用已安装的插件(插件将
                                      可能不起作用)
      --post <name> <value>添加额外的帖子字段(可重复)
      --post-file <name> <path>发布一个附加文件(可重复)
      --print-media-type使用print media-type而不是screen
      --no-print-media-type不要使用打印介质类型而不是
                                      屏幕(默认)
  -p, -  proxy <proxy>使用代理
      --proxy-hostname-lookup使用代理解析主机名
      --radiobutton-checked-svg <path>选中渲染时使用此SVG文件
                                      单选按钮
      --radiobutton-svg <path>在未选中渲染时使用此SVG文件
                                      单选按钮
      --resolve-relative-links将相对外部链接解析为
                                      绝对链接(默认)
      --run-script <js>运行此附加的javascript后
                                      页面加载完成(可重复)
      --disable-smart-shrinking禁用智能收缩策略
                                      由WebKit用来制作像素/ dpi
                                      比率无常数
      --enable-smart-shrinking启用智能收缩策略
                                      由WebKit用来制作像素/ dpi
                                      比率无常数(默认)
      --ssl-crt-path <path> ssl客户端证书公钥的路径
                                      OpenSSL PEM格式,可选择后跟
                                      中级ca和可信证书
      --ssl-key-password <密码> ssl客户端证书私钥的密码
      --ssl-key-path <path> ssl客户端证书私钥的路径
                                      OpenSSL PEM格式
      --stop-slow-scripts停止慢速运行javascripts(默认)
      --no-stop-slow-scripts不要停止慢速运行javascripts
      --disable-toc-back-links不要从节头到toc链接
                                      (默认)
      --enable-toc-back-links从节头到toc的链接
      --user-style-sheet <url>指定要加载的用户样式表
                                      每一页
      --username <username> HTTP身份验证用户名
      --viewport-size <>如果您有自定义,则设置视口大小
                                      滚动条或css属性溢出到
                                      模拟窗口大小
      --window-status <windowStatus>等到window.status等于this
                                      渲染页面前的字符串
      --zoom <float>使用此缩放系数(默认值为1)
页眉和页脚选项:
      --footer-center <text>居中的页脚文字
      --footer-font-name <name>设置页脚字体名称(默认Arial)
      --footer-font-size <size>设置页脚字体大小(默认为12)
      --footer -html <url>添加一个html页脚
      --footer-left <text>左对齐的页脚文本
      -  footer-line页脚上方的显示行
      --no-footer-line不要在页脚上方显示行
                                      (默认)
      --footer-right <text>右对齐的页脚文本
      --footer-spacing <real>页脚和内容之间的间距,单位为mm
                                      (默认为0)
      --header-center <text>居中的标题文本
      --header-font-name <name>设置标题字体名称(默认Arial)
      --header-font-size <size>设置标题字体大小(默认为12)
      --header-html <url>添加一个html标题
      --header-left <text>左对齐标题文本
      --header-line标题下方的显示行
      --no-header-line不在标题下方显示行
                                      (默认)
      --header-right <text>右对齐标题文本
      --header-spacing <real>标题和内容之间的间距,单位为mm
                                      (默认为0)
      --replace <name> <value>将[name]替换为header和中的值
                                      页脚(可重复)
TOC选项:
      --disable-dotted-lines不要在toc中使用虚线
      --toc-header-text <text> toc的标题文本(默认表
                                      内容)
      --toc-level-indentation <width>对于toc中的每个标题级别
                                      按此长度缩进(默认为1em)
      --disable-toc-links不要从toc链接到部分
      --toc-text-size-shrink <real>对于toc中每个级别的标题
                                      字体按此因子缩放(默认值
                                      0.8)
      --xsl-style-sheet <file>使用提供的xsl样式表
                                      打印目录



目录
相关文章
|
1月前
|
数据挖掘 数据安全/隐私保护 开发者
使用Spire.PDF for Python插件从PDF文件提取文字和图片信息
使用Spire.PDF for Python插件从PDF文件提取文字和图片信息
57 0
|
2月前
|
程序员 数据安全/隐私保护 计算机视觉
手把手教你用 Python 去除图片和 PDF 水印
手把手教你用 Python 去除图片和 PDF 水印
78 0
|
3月前
实现将信息作为txt,pdf,图片的形式保存到电脑~
实现将信息作为txt,pdf,图片的形式保存到电脑~
iframe 在线预览pdf、word、excel、ppt、txt、图片、视频
iframe 在线预览pdf、word、excel、ppt、txt、图片、视频
|
4月前
|
JavaScript 前端开发
nodejs实现解析chm文件列表,无需转换为PDF文件格式,在线预览chm文件以及目录,不依赖任何网页端插件
nodejs实现解析chm文件列表,无需转换为PDF文件格式,在线预览chm文件以及目录,不依赖任何网页端插件
|
7月前
|
Python
Python3,2行代码,多种方法,直接把网页内容转换成PDF文档和图片。
Python3,2行代码,多种方法,直接把网页内容转换成PDF文档和图片。
148 0
|
3月前
|
Web App开发 JavaScript 前端开发
网页VUE纯前端在线预览编辑Office,支持doc/docx、xls/xlsx、ppt/pptx、pdf等格式
随着互联网技术的不断发展,越来越多的企业开始采用在线办公模式,微软Office Word 是最好用的文档编辑工具,然而doc、docx、xls、xlsx、ppt、pptx等格式的Office文档是无法直接在浏览器中直接打开的,如果可以实现Web在线预览编辑OffIce,肯定会还带来了更高效、便捷的办公体验,为我们的工作带来了更多可能性。
455 0
|
2月前
|
编解码 数据可视化 数据挖掘
【办公自动化】用Python将PDF文件转存为图片
【办公自动化】用Python将PDF文件转存为图片
57 1
|
1月前
|
机器学习/深度学习 文字识别 数据安全/隐私保护
Python实现从PDF和图片提取文字的方法总结
Python实现从PDF和图片提取文字的方法总结
39 0
|
3月前
|
存储
如何解决网页中的pdf文件无法下载?pdf打印显示空白怎么办?
如何解决网页中的pdf文件无法下载?pdf打印显示空白怎么办?
159 0