个人博客开源文档的建站神仙组合 Vercel + Docusaurus

Posted 2022-07-12 catoop

Docusaurus

如官网大标题所述，我们用它来 快速构建高效的网站，专注内容的处理，一个静态网站生成器。特别适用于博客、笔记、开源文档的编写。国内国外众多的开源项目均使用了 Docusaurus，文档使用 Markdown 编写并可部署在 GitHub Pages 上（本文推荐使用Vercel 自动发布）。

docusaurus 初始化的站点效果图如下所示：

这些内容是初始化后默认的内容，所有内容都是可以自己修改的，它是基于每个 markdown 文档生成的，不需要自己写 html 代码什么的，细节详见官网（https://www.docusaurus.cn/），这里不做赘述。

Vercel

可能你曾听说过 ZEIT Now，它是 Vercel 的前身。在 ZEIT Now 进行了「品牌升级」后成为了现在的 Vercel。

Vercel 它定位是零配置的静态资源和无服务器云计算（serverless) 部署平台，vercel 的 serverless function 背后用的其实是 AWS 的 lambda，因此可以部署在全球多个地区的 AWS 服务器，利用 vercel 的 Edge network （截止 2021.12.22 还在开发beta 阶段）可以实现让访客访问到离自己最近的内容，提高网站速度。

在 Vercel 官网（https://vercel.com）注册一个新账户后，进入个人面板（https://vercel.com/dashboard）页面后，通过「New Project」创建一个项目，与 github 中你的 docusaurus 项目建立连接。

此后，它会自动感知你 github 项目工程的提交动作，并自动进行构建发布。

所以你日常的动作为：
1、在电脑上撰写文档
2、通过 git 提交内容
3、稍等一会后访问你的 vercel 站点即可看到新的文档内容了

如果你有自己的域名，vercel 支持绑定你的域名，实现真正意义感知上的个人站点效果。

现在，注册新用户必须使用 Github、Gitlab 或者 Bitbucket 的账户进行授权。注册完成后，可以在配置页面修改自己的邮箱地址。

---

本文未做详细的配置教程内容，目的是为了分享告诉大家 Vercel + Docusaurus 的组合方案很不错，让有编写个人静态站点、文档和博客需求的你无需任何成本即可轻松搭建一个个人站点。

阅读本文的你，看完后有兴趣最好真实操作一下，相信能带给你不错的体验。

---

（END）