PDF 高级打印方案

[Kenshin]

描述

使用 wkhtmltopdf 来增强导出 PDF 的定制化。

下载地址

这个是 PDF 辅助增强插件的的功能，需要安装 对应的插件

演示

百度网盘

功能比较

同步助手基础/高级打印方案的区别：

	同步助手	依赖	优势	劣势
基础打印功能	1.0.1 版	无需多余依赖，仅使用同步助手	无需 wkhtmltopdf 依赖	阅读模式、稍后读中均可调用
高级打印功能	1.0.2 版	需要安装 wkhtmltopdf	无图片无法显示的问题，且可定制主题、样式等一切内容。	（暂时）仅能阅读模式下使用

wkhtmltopdf

wkhtmltopdf 是一个 HTML → PDF 的第三方库。

下载地址

https://wkhtmltopdf.org/downloads.html 请根据自己的环境找到相应安装包。

安装

安装过程从略，但如果你是 Windows 11 的话，建议不要选择默认位置，请选择其它盘。

验证

进入命令行，并执行 wkhtmltopdf -V 如果有类似输出的话，即说明安装成功。

注意：

如果没有输出的话，请指明 wkhtmltopdf 的安装目录，尤其是 Windows 用户。

使用

当选择了 同步助手高级打印方案 时生效。

除此之外， 同步助手高级打印方案 还提供了众多的定制化功能：

• 主题、字体样式、字体大小

• 自定义字体

• 自定义样式

• 更细致的打印，如页边距、打印尺寸

• 自带目录

• 完美解决因图片防盗链无法成功打印的问题。

[Kenshin]

默认主题

高级打印功能会根据阅读模式设置的主题进行打印，也就说导出的 PDF 会跟你的阅读模式保持一致性，但也可以自主选择其它主题。

一个例子

[helloyan]

同步助手高级打印方案 这个设置再哪里，翻了一圈没找到

[Kenshin]

@helloyan

截图对应的插件在 #2721 另外，前面的描述中也说明了这个链接。
如果你安装后没有找到的话，试试 #2342 提到的解决方案。

[helloyan]

已找到，在”动作”页面最下面

[Kenshin]

自定义样式

不止如此，也可以在主题的基础上微调各种参数。

图片大小

大部分网页都可以通过上图所示的设置修改图片大小

但并不是每个网页都可以正常使用此功能，当无法图片大小修改无效时，可以使用自定义样式解决，将下面的代码

sr-rd-content img {
  max-width: 50%!important;
}

（注意：50% 可以修改为任意尺寸）加入到下面所示的地方

保存后再打印。

[DHS1001]

在这里设定图片宽度后（例如50），在导出的pdf好像不生效。等迟些再试一下其他网站。

[DHS1001]

在这里设定图片宽度后（例如50），在导出的pdf好像不生效。等迟些再试一下其他网站。

好像图片宽度在这里设置无效呀，但是在“全局样式”设置就可以哦

[Kenshin]

@DHS1001

嗨，这个 Bug Fixed 掉了，细节请看这里 #5412 (comment)

[Kenshin]

全局字体

可以支持本机任意字体样式或者使用 Google font 设置全局字体。

@import url('https://fonts.googleapis.com/css2?family=ZCOOL+XiaoWei&display=swap');

body, body sr-rd-content * {
  font-family: "ZCOOL XiaoWei"!important;
}

一个例子

下图就是使用上面的全局字体导出的效果。

[Bioerjzy]

请问本地字体怎么使用？

[Kenshin]

@Bioerjzy

只要知道本地字体的 font-family 直接写就行。

body, body sr-rd-content * {
  font-family: "xxxx"!important;
}

将 xxxx 换成本机任意 font-family 名称。

[Kenshin]

全局样式

可以在这里设置任意全局样式。

[Kenshin]

标注色

因为 wkhtmltopdf 对 CSS 样式支持度的缘故，在此模式下标注色并不能 100% 很好的显示，所以当开启此选项后，无论标注色的样式是什么一律改为统一样式。

建议

如果对标注没有要求的话，请关闭此选项，关闭后将不会显示标注

[Kenshin]

wkhtmltopdf 定制化

支持边距设定与更多的定制化参数。

定制化参数

支持 wkhtmltopdf 全部的定制化参数。

一个例子

--page-size Letter

在每页加入页脚功能

将 --footer-right [page]/[topage] --footer-font-size 8 --footer-spacing 3 粘贴到此处（注意：此方式不能将页边距设置为 0）

效果

[Kenshin]

备注

页边距除了上述参数影响外，还会受到界面的版面布局的影响。

所以，如果要修改页边距的话，需要先按照上图修改，然后刷新当前页面再打印。

---

除此之外不改变版面布局的话，还有个办法，将下面的代码

body {
    margin: 20px 0!important;
}

放到下图所示的位置，然后保存。

备注：

• 20px → 上下边距（一般不用改）

• 0 → 左右边距，设置为0或其它 CSS 3 支持的值。

[Kenshin]

运行目录

指定 wkhtmltopdf 的运行目录

1. Mac 与 Linux 如果默认安装的话，一般来说不需要设置，如设置一般值为 /usr/local/bin/
2. Windows 11 建议不要安装在默认盘和目录，可能会有权限问题导致调用失败，所以这是需要指定运行目录，一般是包含 bin 的目录结构。

[DHS1001]

在win7 64位下，使用默认wkhtmltopdf 的安装目录和放在C盘根目录（均指定运行目录）都提示“导出失败”。
后经各位大佬提示和帮助，把wkhtmltopdf放在非C盘（例如D盘），然后指定运行目录，就成功导出啦。非常感谢！

[EdisonWendy]

请问一下Windows指定运行目录也是/usr/local/bin/吗，怎么指定了还是失败

[Kenshin]

@EdisonWendy

/usr/local/bin/ 是 Mac 下面的地址.... Windows 在安装时有它自己的地址，或者在命令行（似乎）也能看安装地址

[EdisonWendy]

懂了

[Kenshin]

临时目录

大部分用户都不需要开启此选项，当你使用 Onedrive 作为导出目录时建议开启，详细说明 请看这里。

[Kenshin]

RT