hexo-images-watermark

favico

一款用于 Hexo 静态博客网站生成时对图片添加水印。

不对原图产生任何影响，在网站静态页构建过程中将原图读取，输出添加了水印的图片。

在构建的静态网站中不会存在原图，只存在水印图片。

一定要阅读最后的提示事项，包含现有版本的支持情况和即将添加的功能

使用 npm 安装插件

npm install hexo-images-watermark

使用 yarn 安装插件

yarn add hexo-images-watermark

在站点配置文件 _config.yml 中进行如下配置：

watermark:
    enable: true
    textEnable: true
    rotate: -45
    gravity: centre

在 hexo generate 运行后会自动为你的 post 目录下的图片添加水印，新的图片将会覆盖 public/post 下原本的图片，而对 source 源图片不会产生影响。

🚀 HomePage

从 2.0.0 开始支持动态图片 gif 图添加水印，但是位置只能是中间位置，并且一旦水印图片大于源图，则会报错。

水印图片大于源图报错问题目前只存在 gif 动态图上，静态图在本版本中已修复。如果依旧希望能够渲染上去，保持参数 bigSkip为false，则会自动缩放，以适应源图大小。

如果 bigSkip为true，默认值时，则会跳过不渲染，并且输出黄色警告此图片太小。

参数

字段	是否必须	默认值	说明
enable	✅	false	`true` 将会执行图片添加水印，`false` 将会不执行添加
textEnable		false	是否使用文本来添加水印（❌ 警告：目前不支持文本和图片同时添加水印）
imageEnable		false	是否使用图片来添加水印（❌ 警告：目前不支持文本和图片同时添加水印）
static		true	是否渲染静态图
dynamic		true	是否渲染动态图
log		true	是否输出日志信息
directory		true	需要渲染的文件夹，默认为 posts 文件夹

!!! 一定要数组形式

其他详细可以查看更新日志

watermark:
    enable: true
    textEnable: true
    rotate: -45
    gravity: centre
    directory:
        - posts

字段	默认值	说明
gravity	southeast	设置水印位置处于什么方向，以 `上北下南左东右西` 来确定（sharp 插件的配置）
rotate	0	旋转角度，如`45`代表逆时针 45 度，`-45`代表顺时针 45 度
bigSkip	true	是否跳过水印图片比原始图片大的，false，不跳过，按照原始图大小进行缩放，不保证缩放后的质量

gravity 参数可用值：

字段	默认值	说明
text	config.url \| SpiritLing	尽量英文，中文需要引入字体，并且中文有可能发生其他错误，推荐就是不设置，使用 cofig.yml 中的 url
fontPath	undefined	例子：`source/static/font/custom.ttf`
color	rgb(169,169,167)	颜色可以使用 rgb,rgba,#xxxxxx 以及 red 名字式的
fontSize	18	文本字体大小
background	transparent	配合 text 和 rotate 使用，指的是文字转成的图片一旦旋转会出现多余空白，设置这些地方的颜色，一般透明色即可