wkhtmltopdf

以你之姓@ 2022-05-28 03:13 190阅读 0赞

名称：  
  wkhtmltopdf 0.12.4（带补丁的qt）  
  
  
概要：  
  wkhtmltopdf \[GLOBAL OPTION\] ... \[OBJECT\] ... <输出文件>  
  
  
文件对象：  
  wkhtmltopdf能够将多个对象放入输出文件中，一个对象是  
  可以是单个网页，封面网页或内容列表。对象  
  按输入文档中指定的顺序放入输出文档  
  命令行中，可以在每个对象的基础上或在全局中指定选项  
  选项区域。全局选项部分中的选项只能放入  
  全球选项区  
  
  
  页面对象将单个网页的内容放入输出文档中。  
  
  
  （页）？<输入网址/文件名称> \[页面选项\] ...  
  页面对象的选项可以放置在全局选项和页面中  
  选项区域。适用的选项可以在页面选项中找到  
  “页眉和页脚选项”部分。  
  
  
  封面对象将单个网页的内容放入输出文档中，  
  该页面不会出现在内容列表中，并且没有标题  
  和页脚。  
  
  
  封面<输入网址/文件名称> \[页面选项\] ...  
  也可以为页面对象指定的所有选项都可以指定  
  封面。  
  
  
  内容对象表将内容表插入输出文档。  
  
  
  toc \[TOC选项\] ...  
  也可以为页面对象指定的所有选项都可以指定  
  toc，TOC选项部分的选项也可以更多  
  应用。内容表是通过XSLT生成的，这意味着它可以  
  不管你想要它的样子，看起来都很自然。了解如何做到这一点  
  您可以通过提供默认的xslt文件来转储  
  --dump-default-toc-xsl，以及它提供的大纲  
  - 轮廓轮廓，请参阅“轮廓选项”部分。  
  
  
描述：  
  使用wkhtmltopdf修补将一个或多个HTML页面转换为PDF文档  
  QT。  
  
  
全球选项：  
      - 打印多份时，collate分页  
                                      （默认）  
      --no-collate打印多个时不要整理  
                                      副本  
      --cookie-jar <path>读取和写入cookie  
                                      提供的cookie jar文件  
      --copies <number>打印到pdf中的份数  
                                      文件（默认1）  
  -d， -  dpi <dpi>显式更改dpi（这没有  
                                      对基于X11的系统的影响）（默认96）  
  -H，--extended -help显示更广泛的帮助，详述  
                                      不太常见的命令开关  
  -g， - 灰度PDF将以灰度生成  
  -h，--help显示帮助  
      --htmldoc输出程序的html帮助  
      --image-dpi <整数>当嵌入图像缩小到  
                                      这个dpi（默认600）  
      - 图像质量<整数>当jpeg压缩图像使用这个  
                                      质量（默认94）  
      - 许可证输出许可证信息并退出  
  -l， - 低质量生成较低质量的pdf / ps。对...有用  
                                      缩小结果文件空间  
      --manpage输出程序手册页  
  -B，--margin-bottom <unitreal>设置页面底部边距  
  -L，--margin-left <unitreal>设置页面左边距（默认10mm）  
  -R，--margin-right <unitreal>设置页面右边距（默认10mm）  
  -T，--margin-top <unitreal>设置页面顶部边距  
  -O， - 方向<方向>将方向设置为横向或纵向  
                                      （默认肖像）  
      --page-height <unitreal>页面高度  
  -s，--page-size <尺寸>将纸张尺寸设置为：A4，Letter等  
                                      （默认A4）  
      --page-width <unitreal>页面宽度  
      --no-pdf-compression不要在pdf上使用无损压缩  
                                      对象  
  -q，--quiet不那么冗长  
      --read-args-from-stdin从标准输入读取命令行参数  
      --readme输出程序自述文件  
      --title <text>生成的pdf文件的标题（The  
                                      如果不是，则使用第一个文档的标题  
                                      指定）  
      --use-xserver使用X服务器（一些插件和其他  
                                      没有X11的东西可能无法工作）  
  -V，--version输出版本信息并退出  
  
  
大纲选项：  
      --dump-default-toc-xsl将默认的TOC xsl样式表转储到  
                                      标准输出  
      --dump-outline <file>将轮廓转储到文件  
      --outline将大纲放入pdf（默认）  
      - 不提纲不要在PDF中提出大纲  
      --outline-depth <level>设置轮廓的深度（默认4）  
  
  
页面选项：  
      --allow <path>允许指定的文件或文件  
                                      要加载的文件夹（可重复）  
      --background打印背景（默认）  
      --no-background不要打印背景  
      --bypass-proxy-for <value>主机的旁路代理（可重复）  
      --cache-dir <路径> Web缓存目录  
      --checkbox-checked-svg <path>检查渲染时使用此SVG文件  
                                      复选框  
      --checkbox-svg <path>渲染未选中时使用此SVG文件  
                                      复选框  
      --cookie <name> <value>设置一个额外的cookie（可重复），  
                                      值应该被url编码。  
      --custom-header <名称> <值>设置一个额外的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 <编码>设置输入的默认文本编码  
      --disable-external-links不要链接到远程网页  
      --enable-external-links创建指向远程网页的链接（默认）  
      --disable-forms不要将HTML表单字段转换为pdf表单  
                                      字段（默认）  
      --enable-forms将HTML表单域转换为pdf表单域  
      --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-media-error-handling <handler>指定如何处理媒体文件  
                                      无法加载：中止，忽略或跳过  
                                      （默认忽略）  
      --disable-local-file-access不允许转换本地文件  
                                      阅读其他本地文件，除非  
                                      明确允许使用--allow  
      --enable-local-file-access允许转换本地文件进行读取  
                                      在其他本地文件中。（默认）  
      --minimum-font-size <int>最小字体大小  
      - 从大纲中排除不要在页面中包含页面  
                                      内容和概述  
      - 包括概述在目录中包含页面  
                                      和概述（默认）  
      --page-offset <offset>设置起始页码（默认为0）  
      --password <密码> HTTP验证密码  
      --disable-plugins禁用已安装的插件（默认）  
      --enable-plugins启用已安装的插件（插件将  
                                      可能不起作用）  
      --post <name> <value>添加一个额外的帖子字段（可重复）  
      --post-file <name> <path>发布一个附加文件（可重复）  
      --print-media-type使用打印介质类型而不是屏幕  
      --no-print-media-type请勿使用打印介质类型代替  
                                      屏幕（默认）  
  -p，--proxy <proxy>使用代理  
      --radiobutton-checked-svg <path>选中渲染时使用此SVG文件  
                                      单选按钮  
      --radiobutton-svg <path>渲染未选中时使用此SVG文件  
                                      单选按钮  
      --resolve-relative-links将相关外部链接解析为  
                                      绝对链接（默认）  
      --run-script <js>之后运行这个额外的JavaScript  
                                      页面完成加载（可重复）  
      --disable-smart-shrinking禁用智能收缩策略  
                                      由使用像素/ dpi的WebKit使用  
                                      比例不变  
      - 启用智能缩小启用智能缩小策略  
                                      由使用像素/ dpi的WebKit使用  
                                      比率无常量（默认）  
      --stop-slow-scripts停止运行缓慢的javascripts（默认）  
      --no-stop-slow-scripts不要停止运行缓慢的javascripts  
      - 禁用到回退链接不要从节标题链接到toc  
                                      （默认）  
      --enable-toc-back-links从区段标题链接到toc  
      --user-style-sheet <url>指定要加载的用户样式表  
                                      每一页  
      - 用户名<用户名> HTTP认证用户名  
      --viewport-size <>如果您有自定义，请设置视口大小  
                                      滚动条或css属性溢出到  
                                      模拟窗口大小  
      --window-status <windowStatus>等到window.status等于这个  
                                      呈现页面前的字符串  
      --zoom <float>使用此缩放因子（默认值为1）  
  
  
页眉和页脚选项：  
      --footer-center <text>居中的页脚文本  
      --footer-font-name <名称>设置页脚字体名称（默认Arial）  
      --footer-font-size <size>设置页脚字体大小（默认为12）  
      --footer-html <url>添加一个html页脚  
      --footer-left <text>左对齐页脚文本  
      --footer-line在页脚上方显示行  
      - 没有页脚行不要在页脚上方显示行  
                                      （默认）  
      --footer-right <text>右对齐页脚文本  
      --footer-spacing <real>页脚和内容之间的间距（毫米）  
                                      （默认0）  
      --header-center <text>居中的标题文本  
      --header-font-name <name>设置标题字体名称（默认Arial）  
      --header-font-size <size>设置标题字体大小（默认为12）  
      --header-html <url>添加一个html标题  
      --header-left <text>左对齐的标题文本  
      - 标题行显示标题下方的行  
      - 无标题行不要在标题下方显示行  
                                      （默认）  
      --header-right <text>右对齐的标题文本  
      --header-spacing <real>标题和内容之间的间距（毫米）  
                                      （默认0）  
      --replace <name> <value>用标题和中的值替换\[name\]  
                                      页脚（可重复）  
  
  
目录选项：  
      - 禁用虚线不要在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样式表  
                                      打印内容表  
  
  
页面大小：  
  呈现文档的默认页面大小为A4，但使用此  
  - 页面大小选项可以更改为几乎任何其他内容，例如：A3，  
  信和法律。有关支持的页面大小的完整列表，请参阅  
  <http://qt-project.org/doc/qt-4.8/qprinter.html\#PaperSize-enum>。  
  
  
  为了更细致地控制页面大小 - 页面高度和  
  可以使用 - 页面宽度选项  
  
  
从stdin读取参数：  
  如果您需要批量转换大量页面，并且您感觉如此  
  wkhtmltopdf启动起来有点太慢，那么你应该尝试一下  
  --read-ARGS从 - 标准输入，  
  
  
  当--read-args-from-stdin每行输入发送到stdin上的wkhtmltopdf  
  将作为wkhtmltopdf的单独调用，并指定参数  
  在给定的行上加上wkhtmltopdf的参数  
  
  
  例如，可以执行以下操作：  
  
  
  回声“http://qt-project.org/doc/qt-4.8/qapplication.html qapplication.pdf”>> cmds  
  echo“cover google.com http://en.wikipedia.org/wiki/Qt\_(software）qt.pdf”>> cmds  
  wkhtmltopdf  - 读取参数 - 从stdin --book <cmds  
  
  
指定代理服务器：  
  默认情况下，代理信息将从环境变量中读取：  
  代理，all\_proxy和http\_proxy，代理选项也可以通过指定  
  -p开关  
  
  
  <type>：=“http：//”| “SOCKS5：//”  
  <serif>：= <用户名>（“：”<密码>）？“@”  
  <proxy>：=“无”| <类型>？<字符串>？<host>（“：”<port>）？  
  
  
  以下是一些例子（如果您不熟悉BNF）：  
  
  
  HTTP：//用户名：密码@ myproxyserver：8080  
  SOCKS5：// myproxyserver  
  没有  
  
  
页脚和页眉：  
  页眉和页脚可以通过--header- \*和添加到文档中  
  恭敬地参与\*争论。在提供的页眉和页脚文本字符串中  
  到例如--header-left，下面的变量将被替换。  
  
  
   \* \[页面\]替换为当前正在打印的页面数量  
   \* \[frompage\]替换为要打印的第一页的编号  
   \* \[topage\]替换为要打印的最后一页的编号  
   \* \[网页\]替换为正在打印的网页的网址  
   \* \[部分\]替换为当前部分的名称  
   \* \[小节\]改为本款的名称  
   \* \[日期\]以系统本地格式替换当前日期  
   \* \[isodate\]以ISO 8601扩展格式的当前日期替换  
   \* \[时间\]以当前系统本地格式替换当前时间  
   \* \[标题\]替换为当前页面对象的标题  
   \* \[doctitle\]替换为输出文档的标题  
   \* \[网站页面\]由正在转换的当前网站中的页面编号替换  
   \* \[站点页面\]替换当前正在转换的站点中的页面数量  
  
  
  
  
  作为一个例子，指定 -  \[header-right\]“\[toPage\]的页面\[page\]”  
  在文本“y的页面x”中，其中x是当前页面的编号，y是  
  最后一页的数量，出现在左上角  
  文件。  
  
  
  页眉和页脚也可以提供HTML文档。举个例子  
  可以指定--header-html header.html，并使用下面的内容  
  header.html中：  
  
  
  <HTML> <HEAD> <SCRIPT>  
  function subst（）\{  
      var vars = \{\};  
      var query\_strings\_from\_url = document.location.search.substring（1）.split（'＆'）;  
      for（var query\_string in query\_strings\_from\_url）\{  
          if（query\_strings\_from\_url.hasOwnProperty（query\_string））\{  
              var temp\_var = query\_strings\_from\_url \[query\_string\] .split（'='，2）;  
              vars \[temp\_var \[0\]\] = decodeURI（temp\_var \[1\]）;  
          \}  
      \}  
      var css\_selector\_classes = \['page'，'frompage'，'topage'，'webpage'，'section'，'subsection'，'date'，'isodate'，'time'，'title'，'doctitle'，'sitepage '，'sitepages'\];  
      for（var css\_class in css\_selector\_classes）\{  
          if（css\_selector\_classes.hasOwnProperty（css\_class））\{  
              var element = document.getElementsByClassName（css\_selector\_classes \[css\_class\]）;  
              for（var j = 0; j <element.length; ++ j）\{  
                  element \[j\] .textContent = vars \[css\_selector\_classes \[css\_class\]\];  
              \}  
          \}  
      \}  
  \}  
  </ script> </ head> <body style =“border：0; margin：0;” 的onload = “SUBST（）”>  
  <table style =“border-bottom：1px solid black; width：100％”>  
    <TR>  
      <td class =“section”> </ td>  
      <td style =“text-align：right”>  
        <span class =“topage”> </ span>的页面<span class =“page”> </ span>  
      </ TD>  
    </ TR>  
  </ TABLE>  
  </ BODY> </ HTML>  
  
  
  
  
  从示例中可以看出，参数被发送到页眉/页脚  
  HTML文件获得时尚。  
  
  
大纲：  
  带补丁的qt的Wkhtmltopdf支持也被称为书的PDF大纲  
  标记，这可以通过指定--outline开关来启用。轮廓  
  是基于<h？>标签生成的，以便深入说明这是如何实现的  
  完成请参阅Table Of Content部分。  
  
  
  如果传播到<h？>标记，大纲树有时可能非常深  
  慷慨的HTML文件。--outline-depth开关可用于  
  绑定这个。  
  
  
表中的内容：  
  可以通过将toc对象添加到文档中来将内容表添加到文档中  
  命令行。例如：  
  
  
  wkhtmltopdf toc http://qt-project.org/doc/qt-4.8/qstring.html qstring.pdf  
  
  
  内容表根据输入文档中的H标签生成。  
  首先生成一个XML文档，然后使用XSLT将其转换为HTML。  
  
  
  生成的XML文档可以通过将其转储到文件来查看  
  - 转储轮廓切换。例如：  
  
  
  wkhtmltopdf --dump-outline toc.xml http://qt-project.org/doc/qt-4.8/qstring.html qstring.pdf  
  
  
  可以使用--xsl-style-sheet开关指定XSLT文档。对于  
  例：  
  
  
  wkhtmltopdf toc --xsl-style-sheet my.xsl http://qt-project.org/doc/qt-4.8/qstring.html qstring.pdf  
  
  
  --dump-default-toc-xsl开关可用于转储默认的XSLT样式  
  工作表到标准输出。这是编写自己的样式表的好开始  
  
  
  wkhtmltopdf --dump-default-toc-xsl  
  XML文档位于名为“http://wkhtmltopdf.org/outline”的名称空间中  
  称为“outline”的根节点包含多个“item”节点。一个物品  
  可以包含任何数量的项目。这些是大纲的小节  
  项目代表的部分。项目节点具有以下属性：  
  
  
 \*“标题”部分的名称。  
 \*“页面”部分发生的页码。  
 \*“链接”链接到该部分的URL。  
 \*“backLink”部分将链接回的锚点名称。  
  
  
  其余的TOC选项仅影响默认样式表，因此它们不会  
  在指定自定义样式表时工作。  
  
  
  如果您遇到错误或想要申请新功能，请访问  
  <https://github.com/wkhtmltopdf/wkhtmltopdf/issues>