1. 将笔记全面迁移到开源平台
作为一个热爱工作、学习的人,每天都要随手做一些笔记。之前尝试过一些云笔记:
名称 | 开源 | 稳定性 | 富文本编辑 | Markdown | 内置图床 | 免费 |
---|---|---|---|---|---|---|
印象笔记 | N | Y | Y | Y | Y | 基础版免费,有付费服务 |
有道云笔记 | N | Y | Y | Y | Markdown 插入图片需付费 | 基础版免费,有付费服务 |
leanote | Y | N | Y | Y | Y | 基础版免费,有付费服务 |
石墨笔记 | N | Y | Y | 弱 | Y | 基础版免费,有付费服务 |
经过实际使用,最后选择有道云笔记,基础免费版也够用,特别是对 Markdown 支持良好,一键分享也非常好用。但是偶然发现有道分享的文档的阅读量超出预期,加上有部分网友反映,笔记平台可能有隐私问题。出于对数据安全的考虑,准备将笔记全面迁移到开源平台。斜体
经过一番研究,发现了基于 Git 的 GitNote。
Git 对大多数开发人员都不陌生:
- Git 强大的版本管理能力
- 大量免费的 Git 托管平台:知名的 github、gitlab、gitee。技术稳定可靠,信誉良好。
- 我用的 github 在 2019 年 1 月 1 日起,向个人用户提供无限量的个人私有仓库服务。
其实很多程序员本身就使用 git 做自己的文档托管平台,但是毕竟使用起来,跟专业的笔记软件还是有一定差距。 Gitnote 很好的将 Git 的免费、安全、功能强大与笔记软件结合到一起。重度使用两天,功能上可以替代商业笔记软件,它自身也是开源的,客户端安全不是问题,后端直接使用的是 Git,数据托管到 github,自己可以完全掌控自己的数据。
它还提供有用的插件,顺便替代了 viso 和 xmind。BTW,流程图 和 思维导图 都会被自动纳入 Git 仓库,非常方便。
2. 准备工作
2.1 下载 GitNote
前往 GitNote 下载对应版本的安装包,并安装。 GitNote 是基于 electron 和 VUE 实现的,跨平台具有相同的外观,使用感没有差别。 第一次打开,由于还没有导入笔记项目,应该是这样的。 GitNote 的作者是中国人,他的中英文都非常好,如果英文有障碍,点击右下角的 Language 切换成中文就可以。 具体的配置稍后会提到,下面我们准备 Github。
2.2 准备 Github
2.2.1 当然是注册账号了,不再赘述,你至少需要一个可用的邮箱。
注册完,登陆 Github 看起来应该是这样:
2.2.2 建立一个 私有 仓库,用来托管笔记。
访问 https://github.com/new 创建仓库。 填写 Repository name,推荐将仓库命名为 xxnote,一目了然。
特别注意:
- 除非你打算公开所有笔记,否则,务必选择 Private。
- 勾选 Initialize this repository with a README,省去我们自己初始化仓库的工作。
点击 Create repository 完成创建
2.2.3 建立一个 公开 仓库,托管图片。
编写笔记的时候,会用到图片,我们将所有图片也托管到 Github 上。类似上一步,再创建一个仓库。 填写 Repository name,推荐将仓库命名为 xximg 之类,一目了然。
特别注意:
- 务必选择 Public,否则在笔记中无法引用图片。
- 勾选 Initialize this repository with a README,省去我们自己初始化仓库的工作。
点击 Create repository 完成创建
点击右上角自己的头像--->your repositories 查看已创建好的仓库。
注意:note 仓库是 private,img 仓库名称旁边没有权限说明,说明 img 默认是 public。
2.3 配置 GitNote
2.3.1 获得笔记仓库地址
点击绿色的 Clone or download,复制 文本框 中的连接,就是笔记仓库的地址。
2.3.2 初始化 GitNote
打开 GitNote, 点击 clone a repository
local path 需要通过输入框右侧的 select local path 按钮浏览,指定一个本地目录,作为笔记的缓存文件夹。 Remote 填写上面的 笔记仓库 地址。 Email 和 Password 填写 Github 账号,希望你还没有忘记,否则请前往 Github 重置密码。
将右侧的滑动条向下拉,点击 confirm 开始初始化 GitNote。
这个过程其实是 GitNote 在后台,用 git clone 命令,将 Github 上的笔记仓库 clone 到本地文件夹。 如果提示网络错误,这是某些你懂得原因造成的,再试一次就好。 如果提示账号错误,请回到上一步,重新输入账号。
如果一切顺利,你应该可以看到这个界面。
可以看到在 gitnote 下已经有一个 README.md 文件,这是我们创建笔记仓库的时候,自动创建的自述文件,对比一下 GitNote 中的文件和笔记仓库中的文件,GitNote 的工作原理就显而易见了。
2.3.3 安装一些有用的插件
点击这里,1,2
就可以进入插件市场,目前这些插件都是 GitNote 的开发者自己开发的,希望后期会有更多第三方开发者参与进来吧。
推荐大家安装:
- github,将图片托管在 Github 上
- grapheditor,代替 viso 的流程图工具
- kityminder,代替 xmind 的思维导图工具
在安装完成前,不要点击 My extension,否则安装会失败。
其他第三方图床不建议使用,国内总是会有各种原因,造成图床站失联,毕竟笔记是我们珍贵的智力劳动成果,还是一并托管到 Github 为佳。
2.3.4 配置 github 插件
我们会把图片托管到 2.2.3 中创建的 图床仓库,配置方法可以参考 github 插件的文档
2.3.4 最后的设置
点击左下角的齿轮,做一些配置。
建议大家作以下调整:
- reopen last project on startup,自动打开上次的项目,方便。
- 修改 Editor 的默认格式为自己喜欢的格式, html 和 md 可选,建议 md。
- 修改 Daily 的默认格式为自己喜欢的格式, html 和 md 可选,建议 md。
- 修改 默认图片托管平台为 Github。
3. 用起来
点击 Markdown Note,创建一个空白笔记,随便拖拽一个图片到笔记中,上传完毕后,前往笔记仓库和图片仓库,可以看到新增的笔记文件和图片。笔记所有的内容都被托管到 Github 了!!
点击编辑框上面的眼睛可以预览 markdown 文件,再次点击可以进入编辑模式。
其他类似商业笔记软件的功能 GitNote 都有,自行研究即可。
GitNote 的插件可以在这打开,替代 viso 和 xmind 的插件也在这里,如果上一步中插件安装顺利的话。
打开插件标签,点击 grapheditor 插件上的 open 就会打开流程图编辑窗口,编辑完毕,点击 file --> save,流程图就会自动被保存到笔记 gragh 文件夹中。
点击 kityminder 插件上的 open 就会打开思维导图编辑窗口,编辑完毕,点击 save,思维导图会被保存到笔记 mind 目录中。
如果回到 Github 检查笔记仓库,这些文件及文件夹都存在,markdown 和 html 文件还可以直接在 Github 中查看,mind 和 gragh 文件需要在 GitNote 中配合插件查看。
4. 笔记同步
默认下,GitNote 每分钟同步一次文件变化,但是如果你愿意,可以点击左下角的同步按钮,强制同步数据。
5. 查看笔记的历史
所有笔记文件都可以查看修改记录,从创建到最新的所有修改版本都可以随时被恢复(感谢伟大的 Git),在 GitNote 中右键要查看的文件,点击 history 就会出现该文件的所有提交记录。
另外一种方式,是登陆 github,直接查看提交记录,这跟查看代码提交记录是一样的。
6. 总结
GitNote 是一件个人作品,查看作者的自述,该工具开发可以追述到 2013 年的 Java 版本。如今已经是全面基于 JS 实现。几天使用下来,我给出非常积极的评价。感谢作者,让每个人都能完全控制自己的笔记,关注数据安全。
作者还有 VIP 服务,甚至有个技术交流群,他给我带来一种全新的技术变现方式,我准备支持一下,买个 VIP 看看,这个我们下期再聊。