关于vue.js:Yank-Note-系列-01-为什么要自己写笔记软件

6次阅读

共计 3457 个字符,预计需要花费 9 分钟才能阅读完成。

Yank Note 是我编写的一款面向程序员的笔记利用。这里我将会写下一些对于 Yank Note 的文章

tl;dr

我想做一款我本人(用户)能够齐全掌控的笔记软件

缘起

从大学开始,我就始终在尝试应用各种笔记软件,从 Sublime Text 间接编辑文件,到应用印象笔记、OneNote 等各种云笔记,最初我抉择了为知笔记。

然而起初,为知笔记开始免费,越来越臃肿,反馈慢,Bug 也多。最终,我放弃了它。备份笔记花了一些功夫,我开始不再置信云产品,本人电脑上的才是真正属于本人的。

于是我开始寻找一款本地笔记软件,断断续续是用了不少产品,这些当中只有 Joplin 让我应用工夫最长,但也不是齐全称心。前面,我还是回退到了应用 Sublime Text 写 Markdown 的计划。

最终在三年前的某一天,我决定本人写一个供本人应用的笔记工具。花了一个下午工夫,我拼凑出了第一个能够应用的版本。应用 Node.js 做服务端,Vue 做前端。性能简陋到什么水平呢?只有读取和写入文件的性能;没有按钮,只有快捷键;界面随便搭在一起。完完全全就是一个性能简陋且俊俏的记事本。

我过后也不晓得本人须要什么,要做出什么。起初我才缓缓找到这样的指标

  • 界面字大不费眼 :)
  • Markdown 撰写
  • 图片文件保留在本地,导出 Markdown 文件可简略解决离线工作
  • 反对一些流程图表绘制 plantuml mermaid
  • 反对加密解密,用来保留账号等隐衷文件,文件可独自设置明码
  • 不须要更多花哨性能,简略够用就行
  • 尽量少依赖三方库,也不花心思保护,杂凑在一起的性能,恰好工作即可 ^_^
  • 在文档中运行 PHP Python Node.js 代码块

而这时候,界面长这样

总的来说,这时候我还是都是依照本人想法来做这个利用,齐全不思考是否好看,是否不便,只有性能满足本人需要即可。

起初,我的一位共事感觉这个利用很实用,开始应用它。我在掘金上发了一篇文章 Markdown 编辑器 (自家用),掘友 @KDA 评论道:“求更新欠缺,很好用”。于是我开始想,这个货色除了我本人,是不是能够再欠缺欠缺,给其他人应用。

然而这时,才发现我还没给这个编辑器取一个名字。GitHub 仓库名是随便起的“yn”,所以顺着这个,正式起名“Yank Note”

为了不便其他人应用,也决定采纳 Electron 开发,不便启动运行。

进化

这里再思考一下,我到底须要一款怎么的笔记利用,最初我定了上面几点准则,依照重要性排序

  1. 回绝云服务: 数据要保留在本地,利用也要在本机运行,备份和同步的需要能够走 Git 或者云盘,私人笔记,无需合作性能。甚至于图床之类,也不要应用,就存本地。
  2. 回绝专有格局: 应用 Markdown 文件保留所有信息,不要给我什么 json 格局或者其余格局的,万一我哪一天弃用这个软件,要能很不便迁徙。
  3. 开源: 一款软件,我要短暂应用,那么不能是关闭的。如果哪一天利用作者不更新了,我要能本人 fork 一份来本人维持根本的运行。
  4. 可拓展: 这款利用要具备足够的拓展性,我遇到一些本人特定的需要,或者应用软件有不棘手的中央,我要能本人写插件或者拓展来批改和实现。
  5. 克服: 利用须要放弃简略,不要太臃肿,不要太花哨,不要有过多动画烦扰我的操作。比方 Notion 的菜单动画,第一工夫感觉很炫酷,然而应用一下就会感觉很拖沓。而它的一些工具提醒又展现太快,变成操作的烦扰项。这里我十分认同 Sublime Merge 的理念。Sublime Merge 是我应用过的体验最好的 Git 客户端,应用它是一种享受。
  6. 跨平台: 我同时应用 Windows,macOS,Android,iOS。我须要让这款利用是跨平台的,至多在桌面端是要跨平台的。不过我的大部分笔记和文章都是在电脑上实现,手机上只须要记录一些灵感即可,这种需要很多软件都能实现得很好,比方 iOS 自带的备忘录。另外既然文件格式也不是专属,也不绑定云服务,那么很多挪动端的 Markdown 编辑器也能很好的工作,在挪动端跨平台的需要就没那么强烈。

下面的准则都是为了让我能够短暂应用一款软件。如果你认同下面的观点,那么 Yank Note 或者是你的菜。

我是一枚规范的程序员,后端前端嵌入式都搞过,偶然还做下白帽子,当初次要搞前端。这让我的笔记需要有一些特殊性,上面说下我应用 Yank Note 的一些具体场景。

  1. 做笔记: 这是根本需要,我须要做的笔记中有不少代码,代码最好能不便复制和运行。比方学习一些 js 个性的时候,我会将代码片段存下来,下次查看立马就能运行。
  2. 工作日志: 刚毕业那会儿,工作上什么事件根本都能记在脑子里,当初不行了,须要有个中央记录,安顿一些待办事项,工作安顿等。
  3. 写文章: 我发文章比拟少,很多文章都是在工作时候写计划和文档。这时候笔记利用能反对嵌入图形就比拟重要。
  4. 编写工具: 平时在工作中,有不少脚本工具,之前都比拟散落在各处或者阐明比拟少,后续应用就比拟麻烦。而当初它们都对立在 Yank Note 中组织关联。很多脚本和代码都能更不便关上,也能有更丰盛的阐明和 UI 界面。

通过下面这些场景洗礼后,Yank Note 长这样

一些问题

完满不是没有什么能够减少的,而是没有什么能够缩小的。

上面是一些用户问过我,和我做 Yank Note 的时候,思考过的一些问题,大部分都是对于“ 为什么不 ”。

  1. Q: 为什么要采纳 C/S 架构?
    A: 我喜爱浏览器,我平时都是在浏览器中应用 Yank Note,配合浏览器插件我能够做更多事件。当初的架构是重客户端轻服务端,将来还会持续精简服务端逻辑。
  2. Q: 为什么要应用编辑预览离开,而不是所见即所得?
    A: 一来是因为我喜爱文本,我喜爱管制文本,我更喜爱代码的形式来写货色。二是技术起因,富文本编辑器很难做好。我体验过不少富文本编辑器 / 组件,都很难达到我想要的体验,还不如间接文本来得间接。
  3. Q: 为什么没有工具条来调整格局?
    A: 和上一条一样,我喜爱文本,不喜爱过多的 UI。用户应该应用文原本管制格局,写 Markdown。应用 Yank Note 的用户应该是相熟 Markdown 的。当然我也能够偷懒不做这个性能了。
  4. Q: 为什么不做成 VSCode 插件?
    A: VSCode 插件限度还是比拟多,一些性能不能很不便实现,我还是更喜爱浏览器来得简略间接。如果你须要,这个 VSCode 插件 很不错。
  5. Q: 为什么不集成 Git 性能,主动推送到 Github?
    A: 我本人的几个笔记仓库都是依靠 Github 贮存的,所以这个需要还是比拟迫切的。然而我还是想要把 Git 集成排除在 Yank Note 性能之外。每个用户都有本人的习惯来治理 Git 仓库,比方我喜爱 Sublime Merge。当然为了便捷,我也写了一个 Yank Note 插件 来疾速提交和推送内容。
  6. Q: 为什么不做成在线版?
    A: Yank Note 从一开始就是 C/S 架构,只是当初多了 Electron 的一些性能,要做成在线版还是很容易。比方当初的 在线 Demo 就是屏蔽了接口申请的版本。然而做成 Web 服务,那么就违反了我的第一条准则,我不心愿这个编辑器脱离用户的掌控。另外就是 Yank Note 因为异样凋谢,为了拓展性,平安问题很难思考周全(我是业余白帽子)。
  7. Q: 为什么不做文件关联,能够间接关上 Markdown 文件的性能?  
    A: 正如下面所说,Yank Note 异样凋谢,有代码运行,宏替换,HTML 解析等性能。为了更高的拓展性,简直将外部能力齐全放开,包含一些危险的能力如命令执行,任意文件读写等,因而我没做文件关联性能。只能从仓库关上,能够让用户更审慎的关上外来文件。
  8. Q: 是否思考做成双链笔记?
    A: 双链笔记很火,然而我体验过一些双链笔记软件,如 Obsidian,我发现我并不需要它。这篇文章的观点我比拟同意 请不要神化双链笔记。我理论应用笔记的体验来看,我最须要文档之间的单向链接,然而粒度不须要到“块”,到题目即可。反向关联我只须要能晓得以后文档被谁援用即可。我不同意扁平的笔记构造,就像写代码,我不同意所有逻辑都在一个文件。我须要层级,须要能援用模块,晓得以后模块被谁援用就够了。这方面 Yank Note 还要增强。

将来

这几年来我始终应用 Yank Note,开发的性能也是因为本人和用户有需要。我在开发 Yank Note 的过程中,我的编程技能也晋升不少,所以哪怕是出于学习的目标,我也还会持续开发保护上来。

当初能预计到的将来几个欠缺的点:

  1. 加强根底体验
  2. 精简服务端代码
  3. 强化文档之间的链接
  4. 开发简略的挪动端利用

如果你对 Yank Note 感兴趣,想应用或者参加奉献,能够到 Github 理解更多。

本文由「Yank Note – 一款面向程序员的 Markdown 笔记利用」撰写

正文完
 0