由Github托管的记笔记方式

1. 前言:

读这篇笔记, 假如读者有一些博客搭建经验, 应当能很快心领神会, 否则这篇笔记并不适合你.

使用Github托管笔记, 可以直接利用其提供的Github pages服务. 因为我比较喜欢用markdown写笔记, 因此做笔记主要是两种形式: 1. 使用hexo搭建的博客; 2. 使用gitbook[1]. 这两者都可以用markdown进行书写, 而且源文件都托管在Github上, 不必担心笔记软件倒闭 (当然, Github也不是不可能倒闭或者被封的, 但是有生之年应该不至于).

2. 网页搭建准备:

2.1 为什么要有这一节?

直接用Github pages不是不能用, 但是国内访问可用性堪忧, 经常无法访问或者速度过慢. 为此可以考虑使用 netlify[2]或者cloudflare[3]. 我个人推荐cloudflare, 因为cloudflare的CDN要好一点的, 而且还提供web之外的一些其他服务(比如非常好用的cloudflare workers).

2.2 前期准备:

所需的准备不多

  1. 域名一个(必选): 使用cloudflare的cdn托管必须要有域名, 反正也不贵
  2. VPN一个(可选): netlify必须科学上网, cloudflare如果不科学上网访问太慢.

2.3 开始记笔记!

其实至此, 已经没有什么需要做的了, 只需把github pages的自定义域名改一下,改成你在cloudflare中所设置域名(或者子域名),cloudflare会自动对该域名及其子域名开启CDN缓存, 加速访问.

3. 写笔记/博客的图片放哪?

如果与博客网站或者笔记放在一起, 似乎有那么一些不是很方便, 总之我不太喜欢这种方式; 如果用网上的图床, 我又很怀疑图床的可用性(说不定哪天就用不了了, 岂不是成了冤大头).

因此我的首选想法是用github pages托管静态资源, 反正前面有cloudflare进行CDN加速了. 剩余的问题就是如何方便的上传/删除图片, 很幸运的是有这样的软件, 不需要我们自己写: picgo[4] 和 upgit[5].

PicGo主界面

PicGo支持以github为存储的图片上传功能, 且PicGo和upgit都支持在typora中直接使用, 但upgit只支持命令行, 因此windows用户推荐使用picgo. 在Typora验证Picgo时可能会遇到一个小问题:

Typora验证Picgo失败

这里看到Typora报错信息中的端口号, 与自身Picgo设置的监听端口是否一致, 如果有此报错信息, 一般是不一致导致的. 或者是由于CDN缓存延迟, 导致typora无法及时验证, 这个时候, typora就只能用其他图片托管平台了.

推荐开启Picgo中的上传前重命名, 这样一来就可以自定义图片名字了!

最好设置好图片上传路径, 就好批量管理图片了.

4. 总结:

自购域名 + cloudflare / Gitbook + Picgo 就能有较为安心的写作体验(编辑器选择上少不了typora~)

当你开始使用域名搭建笔记网站时, 又能发现cloudflare更神奇的功能~ 有些事进去了, 就出不来了.


由Github托管的记笔记方式
https://www.torch-fan.site/2022/06/25/由Github托管的记笔记方式/
作者
Torch-Fan
发布于
2022年6月25日
更新于
2022年11月15日
许可协议