前言
利用 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 查看