如何搭建一个可同步且低费用的个人文档库环境

简介

在以前我曾经尝试过很多种方式建立我的个人知识库，包括建立个人博客网站，使用 Typecho 来搭建动态博客或是使用 Hexo + Github Pages 来搭建静态博客，同时也使用过类如 Wiki 等开源知识库，也使用过 语雀 等知识管理软件。

但以上通通都有或多或少的缺点：

1. 博客网站上传文章颇为复杂，并不需要网站自带的标签板块功能，网站查看 md 文档样式需要依靠主题，而主题修改门槛较高。
2. Wiki 等开源知识库需要服务器部署，费用较大，且样式调整门槛高。
3. 语雀知识库功能较多，其实也可以作为一种平替选择，且手机端，网页端和电脑端均可同步查看，如果觉得免费额度足够使用的话，不失为一种更好的方式。

我相信很多人编写 md 文档都是使用 Typero 这款软件或是 Vscode ，在这里我所教学的搭建方式正是使用 Typero 。

过程

1. 创建一个Git仓库

首先我们先创建一个 Git 仓库，这里推荐首选 Github ，如果因网络原因那么可以选择 Gitee ，那么我这里先以 Github 为例子，我们创建一个仓库，并设置它的访问权限为私有，这里根据你的文档私密性来选择，如果你想分享给其他人，那么可以选择为公开，填写好其他信息后就可以创建了。

创建好后，我们给 Github 账户增加可以访问的 Token ，用于后面克隆仓库和上传使用，如果你已经对该部分较为熟悉，那么可以跳过第二节。

2. 创建Token和克隆仓库

创建 Token 的步骤可以到网上查询一下，这里给出一张图，我们只需要给这个Token开放的权限为 repo 的全部权限即可，同时需要打开记事本将这个 Token 保存下来，因为它是一次性生成，关闭后就无法查看了。

然后我们打开命令行，打开到克隆仓库所在的盘中，输入命令

git clone xxxx

这里的 xxxx 为你的仓库地址，同时他会要求你填入 Github 的账号名和密码，这里要注意的是密码不要是登录的密码，而是刚才我们创建好的 Token 。

如果没有意外，这个时候仓库已经是 clone 下来了，那么我们就可以在该仓库中创建和编写文档。

3. 文档中图片的上传

我这里使用的 md 编辑器为 Typero ，它内置了一个图像选项，可以自动地使用 PicGo 来进行图片的上传，我们的图床可以选择为 七牛云，腾讯云，阿里云等，根据我们的需要来选择。七牛云需要你拥有一个已备案的域名，且每天有流量额度，不过对于个人来说绰绰有余了，腾讯云和阿里云就差不多一样了，其他那些免费图床就不推荐了，稳定性较差。

4. 文档同步

文档同步的话我们只需要每次编写好新的文档后及时地将文档 push 回仓库即可，后续其他设备需要同步文档也只需要将该仓库克隆下来即可，非常方便。

总结

1. 这套方案唯一需要费用的地方是图床，如果网络条件允许且对私密度要求不高的话，可以选择 Github 作为我们的图床，那么这套方案就是 0 成本了。
2. 优点是安全性和稳定性非常足，且环境搭建步骤不难，使用 Typero 来进行 md 文档编写非常地快捷方便。
3. 缺点是移动设备端无法快捷地查看文档，这个后续优化一下方案，不过这肯定意味着搭建步骤会变得相对繁琐。