一款用于 Hexo 静态博客网站生成时对图片添加水印。
不对原图产生任何影响,在网站静态页构建过程中将原图读取,输出添加了水印的图片。
在构建的静态网站中不会存在原图,只存在水印图片。
原始文章图片
水印图片
一定要阅读最后的提示事项,包含现有版本的支持情况和即将添加的功能
使用 npm
安装插件
npm install hexo-images-watermark
在站点配置文件 _config.yml
中进行如下配置:
watermark:
enable: true
textEnable: true
rotate: -45
gravity: centre
在 hexo generate
运行时会自动为你的 _post
目录下的图片添加水印,新的图片将会放到 public
目录中对应的位置。
默认值:无
说明:true
将会执行图片添加水印,false
将会不执行添加
默认值:false 说明:是否使用文本来添加水印(❌警告:目前不支持文本和图片同时添加水印)
默认值:false 说明:是否使用图片来添加水印(❌警告:目前不支持文本和图片同时添加水印)
默认值:使用配置文件中的url,一旦url不存在直接显示作者名字(SpiritLing) 说明:当你使用的文字过长时,一旦转为图片后大于待加水印的图片尺寸,则会出现错误。
默认值:undefined,使用 text-to-svg
自带字体
说明:自己加载需要的字体,支持单个字体文件,不区分中英文;如果纯中文,请只加载中文字体,例:需要加载 source/static/font/custom.ttf
字体直接将其写入到配置文件中即可
默认值:rgb(169,169,167)
说明:颜色可以使用 rgb,rgba,#xxxxxx以及red名字式的。
默认值:southeast
说明:设置水印位置处于什么方向,以 上北下南左东右西
来确定
参数可用值:
类型 | 说明 | 备注 |
---|---|---|
centre | ** | 图片正中间 |
north | 北 | 上方中间 |
west | 东 | 左边中间 |
south | 南 | 下边中间 |
east | 西 | 右边中间 |
northwest | 东北 | 左上角 |
southwest | 东南 | 左下角 |
southeast | 西南 | 右下角 |
northeast | 西北 | 右上角 |
默认值:18
说明:文本字体大小,
默认值:watermark.png
说明:水印图片,放置在source文件根路径的图片名称;
默认值:50
说明:对图片进行缩放。
默认值:50
说明:对图片进行缩放。
默认值:0
说明:旋转角度,如45
代表逆时针45度,-45
代表顺时针45度
默认值:transparent 说明:配合text和rotate使用,指的是文字转成的图片一旦旋转会出现多余空白,设置这些地方的颜色,一般透明色即可
- 文字不要过长过大,水印图片不要过大(太大可以使用缩放,
⚠️ 但是缩放是全局性的),否则都会出现错误,终止生成静态页面 - 暂不支持图片和文字共同添加
- 目前只支持
*.jpg
,*.jpeg
,*.png
两种格式图片,并且只支持source/_posts
文件夹下的图片,也就是文章本地图片;同时也不支持远程图片 - 水印图片也不支持远程和非soucre根路径下的文件,也是只支持
*.jpg
,*.jpeg
,*.png
两种格式图片 - 不支持循环满图添加水印
- 请使用
1.1.x
以上版本,1.0.x
是进行Hexo api相关测试时使用的,版本杂乱无章,使用1.0.x
版本出现任何问题,概不理会
- 文字水印
- 自定义文字,颜色,大小
- 自定义字体 - 2019-12-24 Done
- 支持循环添加
- 超限处理
- 图片水印
- 自定义水印图片
- 远程水印图片
- 支持循环添加
- 超限处理
- 位置
- 固定位置:九个方位
- 自定义 top,left
- 旋转
- 缩放(仅限图片)
- 其他格式支持