wkhtmltopdf 协助后端导出复杂pdf文件的第三方软件(2)

风格不统一 提交于 2019-12-02 21:43:03

(1)术语定义

文档对象
“文档对象”是指PDF文档中的文档对象,共有三种类型的“文档对象”,他们分别是“页面对象”,“封面对象”和“目录对象”。
页面对象
“页面对象”是指以页面的形式在PDF文档中呈现的对象,这个是相对于“封面对象”和“目录对象”来讲的。此类对象会成为PDF文档中内容。
封面对象
“封面对象”是指以封面的形式在PDF文档中呈现的对象。这类对象会成为PDF文档中的封面。
目录对象
“目录对象”是以目录的形式在PDF文档中呈现的对象,又叫“TOC对象”。这类对象会成为PDF文档中的目录。
大纲
“大纲”是指阅读PDF文档时的书签导航。
外链
“外链”是指所有在这个页面中且不指向它自身页面中锚点的超链接。
内链
“内链”是指在这个页面中且指向的目标页面是这个页面本身中的一个锚点的超链接。

(2)命令格式

wkhtmltopdf [GLOBAL OPTION]... [OBJECT]... <output file>

上述代码就是 wkhtmltopdf 的命令行格式,看似简单,其实在 [GLOBAL OPTION] 和 [OBJECT] 中还别有洞天。预知详情,且听我慢慢道来。

(3)参数

常规选项

–allow <path> 允许加载从指定的文件夹中的文件或文件(可重复)
–book* 设置一会打印一本书的时候,通常设置的选项
–collate 打印多份副本时整理
–cookie <name> <value> 设置一个额外的cookie(可重复)
–cookie-jar <path> 读取和写入的Cookie,并在提供的cookie jar文件
–copies <number> 复印打印成pdf文件数(默认为1)
–cover* <url> 使用HTML文件作为封面。它会带页眉和页脚的TOC之前插入
–custom-header <name> <value> 设置一个附加的HTTP头(可重复)
–debug-javascript 显示的javascript调试输出
–default-header* 添加一个缺省的头部,与页面的左边的名称,页面数到右边,例如: –header-left '[webpage]’ –header-right ‘[page]/[toPage]' –header-line
–disable-external-links* 禁止生成链接到远程网页 –disable-internal-links* 禁止使用本地链接 –disable-javascript 禁止让网页执行JavaScript
–disable-pdf-compression* 禁止在PDF对象使用无损压缩
–disable-smart-shrinking* 禁止使用WebKit的智能战略收缩,使像素/ DPI比没有不变
–disallow-local-file-access 禁止允许转换的本地文件读取其他本地文件,除非explecitily允许用 –allow
–dpi <dpi> 显式更改DPI(这对基于X11的系统没有任何影响)
–enable-plugins 启用已安装的插件(如Flash –encoding <encoding> 设置默认的文字编码
–extended-help 显示更广泛的帮助,详细介绍了不常见的命令开关
–forms* 打开HTML表单字段转换为PDF表单域
–grayscale PDF格式将在灰阶产生 –help Display help
–htmldoc 输出程序HTML帮助 –ignore-load-errors 忽略claimes加载过程中已经遇到了一个错误页面
–lowquality 产生低品质的PDF/ PS。有用缩小结果文档的空间
–manpage 输出程序手册页
–margin-bottom <unitreal> 设置页面下边距 (default 10mm)
–margin-left <unitreal> 将左边页边距 (default 10mm)
–margin-right <unitreal> 设置页面右边距 (default 10mm)
–margin-top <unitreal> 设置页面上边距 (default 10mm)
–minimum-font-size <int> 最小字体大小 (default 5)
–no-background 不打印背景 –orientation <orientation> 设置方向为横向或纵向
–page-height <unitreal> 页面高度 (default unit millimeter)
–page-offset* <offset> 设置起始页码 (default 1)
–page-size <size> 设置纸张大小: A4, Letter, etc.
–page-width <unitreal> 页面宽度 (default unit millimeter)
–password <password> HTTP验证密码
–post <name> <value> Add an additional post field (repeatable)
–post-file <name> <path> Post an aditional file (repeatable)
–print-media-type* 使用的打印介质类型,而不是屏幕
–proxy <proxy> 使用代理
–quiet Be less verbose
–read-args-from-stdin 读取标准输入的命令行参数
–readme 输出程序自述 –redirect-delay <msec> 等待几毫秒为JS-重定向(default 200)
–replace* <name> <value> 替换名称,值的页眉和页脚(可重复)
–stop-slow-scripts 停止运行缓慢的JavaScripts
–title <text> 生成的PDF文件的标题(第一个文档的标题使用,如果没有指定)
–toc* 插入的内容的表中的文件的开头 –use-xserver* 使用X服务器(一些插件和其他的东西没有X11可能无法正常工作)
–user-style-sheet <url> 指定用户的样式表,加载在每一页中 –username <username> HTTP认证的用户名
–version 输出版本信息退出 –zoom <float> 使用这个缩放因子 (default 1)

页眉和页脚选项

–header-center* <text> (设置在中心位置的页眉内容)
–header-font-name* <name> (default Arial) (设置页眉的字体名称)
–header-font-size* <size> (设置页眉的字体大小)
–header-html* <url> (添加一个HTML页眉,后面是网址)
–header-left* <text> (左对齐的页眉文本)
–header-line* (显示一条线在页眉下)
–header-right* <text> (右对齐页眉文本)
–header-spacing* <real> (设置页眉和内容的距离,默认0)
–footer-center* <text> (设置在中心位置的页脚内容)
–footer-font-name* <name> (设置页脚的字体名称)
–footer-font-size* <size> (设置页脚的字体大小default 11)
–footer-html* <url> (添加一个HTML页脚,后面是网址)
–footer-left* <text> (左对齐的页脚文本)
–footer-line* 显示一条线在页脚内容上)
–footer-right* <text> (右对齐页脚文本)
–footer-spacing* <real> (设置页脚和内容的距离)
./wkhtmltopdf –footer-right '[page]/[topage]' https://www.baidu.com baidu.pdf
./wkhtmltopdf –header-center '报表' –header-line –margin-top 2cm –header-line http://192.168.212.139/oma/ oma.pdf

表内容选项中

–toc-depth* <level> Set the depth of the toc (default 3)
–toc-disable-back-links* Do not link from section header to toc
–toc-disable-links* Do not link from toc to sections
–toc-font-name* <name> Set the font used for the toc (default Arial)
–toc-header-font-name* <name> The font of the toc header (if unset use –toc-font-name)
–toc-header-font-size* <size> The font size of the toc header (default 15)
–toc-header-text* <text> The header text of the toc (default Table Of Contents)
–toc-l1-font-size* <size> Set the font size on level 1 of the toc (default 12)
–toc-l1-indentation* <num> Set indentation on level 1 of the toc (default 0)
–toc-l2-font-size* <size> Set the font size on level 2 of the toc (default 10)
–toc-l2-indentation* <num> Set indentation on level 2 of the toc (default 20)
–toc-l3-font-size* <size> Set the font size on level 3 of the toc (default 8)
–toc-l3-indentation* <num> Set indentation on level 3 of the toc (default 40)
–toc-l4-font-size* <size> Set the font size on level 4 of the toc (default 6)
–toc-l4-indentation* <num> Set indentation on level 4 of the toc (default 60)
–toc-l5-font-size* <size> Set the font size on level 5 of the toc (default 4)
–toc-l5-indentation* <num> Set indentation on level 5 of the toc (default 80)
–toc-l6-font-size* <size> Set the font size on level 6 of the toc (default 2)
–toc-l6-indentation* <num> Set indentation on level 6 of the toc (default 100)
–toc-l7-font-size* <size> Set the font size on level 7 of the toc (default 0)
–toc-l7-indentation* <num> Set indentation on level 7 of the toc (default 120)
–toc-no-dots* Do not use dots, in the toc

轮廓选项

–dump-outline <file> 转储目录到一个文件
–outline 显示目录(文章中h1,h2来定)
–outline-depth <level> 设置目录的深度(默认为4)

页脚和页眉

  • [page] 由当前正在打印的页的数目代替
  • [frompage] 由要打印的第一页的数量取代
  • [topage] 由最后一页要打印的数量取代
  • [webpage] 通过正在打印的页面的URL替换
  • [section] 由当前节的名称替换
  • [subsection] 由当前小节的名称替换
  • [date] 由当前日期系统的本地格式取代
  • [time] 由当前时间,系统的本地格式取代
标签
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!