Matrix 首页推荐

Matrix 是少数派的写作社区,我们主张分享真实的产品体验,有实用价值的经验与思考。我们会不定期挑选 Matrix 最优质的文章,展示来自用户的最真实的体验和观点。

文章代表作者个人观点,少数派仅对标题和排版略作修改。


当 Drafts 和 vim 两个各自平台上最强的文本编辑器相遇时会擦出怎么样的火花?看本文娓娓道来。

Previously

在之前的文章《我的文章阅读闭环》里提到我会使用 Drafts 的 prompt step 给草稿打上标签通过 URL Scheme 发送给 Bear 保存,这样可以很方便快速地给文章打上标签。但是此时我有了另一个想法:既然我可以通过这个 action 给文章打上标签,那么能不能同样通过这个 action 直接跳转到 Bear 打开这个标签文章页面?这是什么概念呢?就是同一个 action,我要它既能有添加标签的功能也要有打开标签的功能,有个想法就该开始思考怎么把想法落地了。

引入 vim 思想

在 vim 中在正常模式 (Normal Mode) 下可以通过按下 i 插入文本、a 追加文本、dd 删除当前行等等实现一系列操作。那么我们就可以把这个思想带入到 Drafts 里,上面提到我除了想让这个 action 有添加标签的功能之外还要有打开标签的功能,那么我们就可以考虑用字母来定义这个功能。比如说如果我的草稿内容只包含 t 或者 T 那么就打开指定的标签文章界面而不是添加标签。

URL Scheme 复用

什么是 URL Scheme 复用?之前没有人在社区提出过这个概念,也没有人做过,这是我自己创造的一个词。具体来说就是通过一个 URL Scheme 实现两个功能。就比如现在「添加标签」和「打开标签」的两个功能,但是我要它在同一个 URL Scheme 里实现。那么这要如何实现呢?这就涉及到了 URL Scheme 的一个特性了,对于传入的参数如果不是这个功能所包含的,那么这个参数就会被忽略掉。这个特性我以前是不知道的,但是某一天晚上在思考这个问题的时候突然来了灵感,感觉说这样是可行的,结果去尝试了竟然成功了。

以 Bear 打开指定笔记的 URL Scheme 为例,打开指定笔记的 URL Scheme 有且只有两个参数:idtitle,这两个参数二选一传入一个即可打开指定的笔记,下面三种传参方式都可以正确地打开一条指定的笔记:

bear://x-callback-url/open-note?id=笔记ID
bear://x-callback-url/open-note?title=笔记标题
bear://x-callback-url/open-note?id=笔记ID&title=笔记标题

那么如果我在它的最后添加了一个 test 参数之后还能正常打开指定笔记吗?比如像这样:

bear://x-callback-url/open-note?title=笔记标题&test=随意参数
bear://x-callback-url/open-note?test=随意参数&title=笔记标题

当然可以,因为 test 参数不是打开指定笔记所包含的参数,所以 test 参数以及参数值会被忽略,只执行有效的 URL Scheme 参数。有了这个理论基础,我们就可以开始尝试构造可复用的 URL Scheme,打开指定标签和文章添加标签的两条 URL Scheme 如下所示:

bear://x-callback-url/open-tag?name=[[tag]]
bear://x-callback-url/create?title=[[head]]&text=[[content]]&tags=[[prompt_button]]

把两条 URL Scheme 参数整合一下得到:

bear://x-callback-url/create?title=[[head]]&text=[[content]]&tags=[[prompt_button]]&name=[[tag]]

但是这时候我们发现前面的 createopen-tag 这两个动作不可能二合一放在一起实现,所以指定 URL Scheme 使用什么动作可以就要通过 JavaScript 实现。我们需要给动作名起一个变量,就叫 [[action]] 吧,最后我们得到这样一个可复用的 URL Scheme:

bear://x-callback-url/[[action]]?title=[[head]]&text=[[content]]&tags=[[prompt_button]]&name=[[tag]]

JavaScript 代码修改

现在我们来实现刚才定义的 [[action]] 变量,如果草稿内容只有一个 t 或者 T 字母就指定 URL Scheme 为 open-tag 动作打开指定标签,否则执行 create 动作创建包含标签的新笔记,完整的代码在 Drafts/笔记添加标签.js,判断功能实现代码实现如下:

// vim mode
if(text.match(/t|T/) && text.length == 1){
    tag = draft.getTag("prompt_button") || '';
    draft.defineTag("tag", tag);
    draft.defineTag("action", 'open-tag');
} else {
    draft.defineTag("action", 'create');
}

最后经过测试,完美实现了我需要的功能:如果草稿内容只有一个 t 或者 T 执行动作之后打开指定标签页面,如果是其他内容就会将草稿内容打上标签保存为新笔记。我们借用 vim 的字母操作思想以及 URL Scheme 无效参数会被忽略的特性实现了一个 action 里面的 URL Scheme 复用,可以让单个 action 的功能更加实用或者强大。

笔记追加内容

我的另一个 action 功能是笔记追加内容,在 Bear 中我存了很多类型的日记,比如:生活日记、生活随记、成功日记、电影日记等等,我平时想写点什么就直接在 Drafts 里面直接写了然后选择笔记就可以直接追加到指定笔记的顶部,如图所示:

电影日记追加内容
电影日记追加内容

这个 action 原来没有 URL Scheme 复用之前的 URL 是这样的:

bear://x-callback-url/add-text?id=[[id]]&mode=prepend&text=-%20[[date|%Y-%m-%d %-H:%M %A]]%0A[[text]]%0A&open_note=yes

URL Scheme 复用之后:

bear://x-callback-url/[[action]]?id=[[id]]&mode=prepend&text=-%20[[date|%Y-%m-%d %-H:%M %A]]%0A[[text]]%0A&open_note=yes

因为追加文本和打开文本都可以通过传入 id 参数实现,所以这里的 URL Scheme 复用前后没有增加多余的参数,只是把 add-text 修改为了 [[action]] 变量。同理,我们需要在 JavaScript 代码里实现这个操作判断并定义 [[action]] 变量,完整代码在 Drafts/笔记追加内容.js,判断功能实现代码如下:

// vim mode
if(text.match(/t|T/) && text.length == 1){
   draft.defineTag("action", 'open-note');
} else {
   draft.defineTag("action", 'add-text');
}

最终效果

内容添加标签
内容添加标签
打开指定标签
打开指定标签
笔记追加内容
笔记追加内容
打开指定笔记
打开指定笔记

本文中的所有代码都可以在 Apple-Automation/Drafts 中找到,如果方便希望能帮我 star 一下,如果有任何需求或者 bug 也可以通过 issue 报给我。如果有兴趣也可以关注我的频道 James Notes


> 下载 少数派 2.0 客户端、关注 少数派公众号,解锁全新阅读体验 📰

> 实用、好用的 正版软件,少数派为你呈现 🚀