前言
利用 Docusaurus + Vercel ,动动手指只需要花上5分钟就可以搭建一个属于自己的博客,可以看下我赶在2021年最后一天搭建的博客。
搭建过的一些站点
对比来说,vercel
是最方便的,也是极力推荐的。
vercel
优势
- 免费域名
- 免费证书
- 自动构建
- 多种模板可选择
serverless
接口
如何选择文档工具
现在的工具太多了,比如我上面列举的 Docsify
| Vuepress
| Docusaurus
等等, 我觉得还是根据个人需求和喜好来,比如做工具文档用 Docsify
更合适,做博客(包含文档) Docusaurus
更合适,喜欢 Vue
的用 Vuepress
更合适。
搭建
选择模板
打开 vercel
官网可以发现它提供非常丰富的模板,常见的包括 Next.js
| Nuxt.js
| Vue.js
等等,你可以在模板中选择自己想要的,我这里选择的是 Docusaurus 2
登录
选择好模板以后,会提示登录,vercel
有多种登录方式,建议使用 GitHub
登录
创建仓库
登录成功后,自定义一个 GitHub
仓库名称,点击 Create
,vercel
会帮你创建好私有仓库并初始化项目
子域名
成功后,vercel
会生成一个可访问的子域名
写博客
到 GitHub
把仓库克隆下来,然后修改即可,推送到 main
分支或提交 pr
,会自动触发构建,具体可以查看这里,vercel
会帮你提供一个预览地址
自动构建
pr
被合并后,会触发自动构建,构建成功后,GitHub
邮箱会收到构建成功的提示,真得是非常方便,节省我们配置 GitHub Action
的操作。大概的原理是 vercel
有一个 GitHub App
, 我们登录 vercel
时,会对这个 App
授权,可以在 GitHub-Settings-Applications
查看