内部链接
- [[技术折腾 xLog 1 可行性探索]]
- [[技术折腾 xLog 2 深入理解 xlog 的鉴权]]
- [[技术折腾 xLog 3 实现一个 obsidian 插件]]
- [[技术折腾 xLog 4 用 unStorage 封装 xLogDriver]]
- [[速通 - xLog 背后的 CrossBell SDK]]
- [[从官方 XLOG Obsidian 插件中能学到什么]]
- [[开发 Obsidian Sync To Xlog 插件之 处理 obsidian 的图片]]
- [[速通-CrossBell 的开源作品]]
- [[速通 Obsidian Docs - 侧重插件开发]]
本文是系列文章的第三章,承接 [[技术折腾 xLog 2 深入理解 xlog 的鉴权]],本文在前两章节的基础上开始尝试制作一个 obsidian 插件。
预计本文会是一个长期更新的项目,你可以持续关注本文,获取更新的动态。另外本文在 xlog 平台至少价值 5 个币的赞赏,嘻嘻,欢迎赞赏。
本文经验可以迁移复用,比如你是其他笔记的用户,可以参考实现。当然有赏金的话,我不介意接单~
背景
作为一个 obsidian 的忠实用户,我日常的所思所想会记录在 obsidian 上,这就意味着,我需要先在 obsidian 上编写文章,然后复制内容到 xlog 上,图片部分需要额外注意。
如果后续我们编辑了 obsidian 的内容,也需要注意同步保持一致,如果有一个插件,我只需要在笔记上选择上传,就同步到 xlog 上就好了。
那,我们就实现一个吧。
设计思路
整体的设计思路分几步:
- 技术预研,跑通接口
- 设计 obsidian 插件
- 实现 obsidian 插件
- 打包分发 obsidian 插件
- 宣传试用 obsidian 插件
技术预研
在上一节,我们实现了文章的创建和更新,利用 siwe token 可以轻松实现文章管理。其他操作暂不实现。
这一部分我们默认已经掌握,如果不理解,可以阅读上一章节内容。
插件设计
这里需要前置 obsidian 的开发经验,这里先略过细节,我维护了一个简单的 obsidian-vue-starter 模板,对 vue 用户比较友好。Github Repo
我们在模板的基础上进行开发。
我们希望插件这样使用。
用户应该开启插件设置,并且正确添加了 token/charactorID,有一个按钮进行连接测试。
在对应笔记的列表上单击右键出现“上传到 xlog”,点击触发上传操作。
上传校验时候,检查 front-matter 要求添加:
- 可选的 tags
- 可选的 slug
- 可选的 summary
- 必填的 title
- 可选的 noteId,如果存在视为更新
暂时忽略 charactorID 这个应该是少数需求
如果当前内容包含 video/audio/image ,限制文件大小,提示是否上传到 xlog 替换为 ipfs 链接。
文件上传完成,回填修改 noteID 参数,后续走更新的操作。
实现插件
目前我会在 github 上进行这个公开的开源项目: https://github.com/Otto-J/sync-to-xlog
目前功能趋近完善了,近期的几篇文章都是通过插件完成的。
访问 https://github.com/Otto-J/sync-to-xlog/releases 可以获得最新版本。
打包分发
投稿了官方插件市场,待审批上架。
更新:已上架官方插件市场
宣传试用
争取获得官方的认可。
给官方说了一声。
在 B 站录了一个简单的视频介绍: 《介绍我开发的 Obsidian-sync-xlog 插件:轻松帮你同步 obsidian 内容到 xlog 上》
未来几天开始认真宣传。
更新:得到了官方的认可和转发,还进一步聊了聊。