Skip to content

一个为知笔记(WizNote)的图片本地化插件,可以将笔记中所有的网络图片下载至笔记本地并替换。

License

Notifications You must be signed in to change notification settings

richex-cn/wiz-plugin-picture-localize

Folders and files

NameName
Last commit message
Last commit date
Mar 7, 2020
Oct 13, 2022
Oct 12, 2022
Oct 12, 2022
Jul 15, 2019
Oct 8, 2021
Oct 12, 2022
Oct 13, 2022
Oct 13, 2022
Jul 15, 2019
Jul 15, 2019

Repository files navigation

为知笔记图片本地化插件 star

996.icu

一个为知笔记(WizNote)的图片本地化插件,可以将笔记中所有的网络图片下载至笔记本地并替换。

保存在为知笔记中的图片,很多图片有可能是引入的网络资源,时间一长如果图片服务器被关闭或者图片被删除导致无法访问,那么笔记中的图片也将无法加载显示。

通过本插件可以将笔记中的图片全部保存在本地笔记中,比起引用网络资源,保存到本b地后图片和笔记保存在一起,不用再担心图片资源失效的问题,还可以在没有网络的环境下正常查看笔记。

插件暂时仅在 Windows 10 下测试通过,其他版本或系统欢迎使用过的通过 Issue 反馈。

插件名称

PictureLocalize(图片本地化)

插件安装

下载 Picture.Localize.wizplugin 文件,双击运行即可。

Note: 如果您使用的是便携版本的为知笔记,可能无法直接双击为知笔记 plugin 文件进行安装,可以将下载的文件拖放到为知笔记窗口上面进行安装(建议拖放到标题栏,在文档窗口中会被当成附件添加)。

插件位置

笔记顶部工具栏的本地化网络图片按钮,如下图:

20190417_140250

插件用途

提供图片本地化功能,将笔记中所有的网络图片下载至笔记本地并替换,主要是为了解决以下几个问题:

  1. 预防笔记图片为网络图片时,在离线环境下无法查看
  2. 防止网络资源服务器关闭服务等无法访问的情况下,图片无法正常打开的问题

将所有图片下载并转换为笔记自带图片,有效的预防了上述可能遇到的问题,同时也可以很方便的进行导出等工具(解压ziw文件)

使用方式

在笔记是非编辑的状态下,点击工具栏中的本地化网络图片按钮,稍等片刻后会出现 所有网络图片已经下载并转换到本地! 的提示。

兼容4.5以后的客户端版本,插件调试开发的环境是为知笔记 4.11.18 版本,Windows 10。

  • 可能出现没考虑到的情况,使用后出现问题可以通过笔记历史版本功能还原即可,对于遇到的问题欢迎提 Issue 或者 PR
  • 考虑到编辑器很多,无法做到一一兼容,所以请统一在笔记是非编辑模式下使用该插件
  • 点击按钮后的等待时间视网络情况不同,建议耐心等待不要做其他操作
  • 出现提示后即代表笔记已更新,会自动刷新笔记,如需还原可通过历史版本功能恢复
  • 兼容任意格式的笔记(Markdown 和 HTML),插件只会处理网络图片资源,笔记中引入的本地图片不会二次处理,放心使用!

注意事项

关于部分使用图片懒加载的网站(例如 data-original 等属性)

部分网页为了优化体验减少资源浪费,会采用图片懒加载技术,页面没有滚动到对应位置时图片不会显示或者显示成 loading 加载图片,针对这个问题,请各位在保存文章的时候手动快速滑动一下网页,保证所有图片正常加载显示之后,再进行保存就不会有问题了。

之所以不考虑在插件当中直接实现,是因为懒加载的图片真实路径存储位置无法确定,不同网站、不同开发者会有各种不同的变化,可以用 data-original="imgSourceUrl" 也可以用 data-pic data-img 等等,更甚者可以直接用类似于 data-img="0" 标记图片索引的方式,所以各位记住保存之前,先滚动一下页面,图片全部正常显示后再保存笔记就可以解决啦。

对于已经保存的笔记又使用了图片懒加载的网站,可以尝试在笔记信息中找到保存时的原网页重新保存一遍,如下图:

如果没有 URL 或者原网页失效的情况,可以通过源代码等方式保存图片,如果仍然无法解决,可以尝试联系我帮忙看一下。

关于二次开发

如果你需要自行进行二次开发,请注意 src 目录中的文件都是 UTF-8 编码,但是官方要求是 Unicode (UTF-8 LE 小端序) 编码,在调试和打包时请手动将 src 目录下的所有文件转换编码,否则可能出现异常。

其他说明

  • 因为个人在保存文档的过程中,遇到一些笔记在保存后仍然使用网络图片的情况(例如粘贴内容到Wiz.Editor.md编辑器中等),为了防止网络图片资源失效,特做了一个小插件以解决该问题,将图片保存至笔记中。
  • 插件是以 4.5 以后的版本调试开发的,因为 4.5 版本前后的客户端插件开发方式不同,所以不保证 4.5 之前的客户端兼容性。
  • 顺便的确想吐槽一些开发文档确实是有点乱,建议官方优化一下,这样也好让更多开发者为Wiz的插件生态做贡献不是吗?

开发文档

文件说明

/Picture.Localize.wizplugin 为插件文件,通过将 /src 下的文件打包成 zip 并将后缀名更名为 wizplugin 即可。

相关链接

如何安装为知笔记插件

4.4 版本插件开发API文档

4.5 版本插件开发API文档

About

一个为知笔记(WizNote)的图片本地化插件,可以将笔记中所有的网络图片下载至笔记本地并替换。

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published