天天看點

個人部落格、開源文檔的建站神仙組合 Vercel + Docusaurus

Docusaurus

如官網大标題所述,我們用它來 快速建構高效的網站,專注内容的處理,一個靜态網站生成器。特别适用于部落格、筆記、開源文檔的編寫。國内國外衆多的開源項目均使用了 Docusaurus,文檔使用 Markdown 編寫并可部署在 GitHub Pages 上(本文推薦使用Vercel 自動釋出)。

docusaurus 初始化的站點效果圖如下所示:

個人部落格、開源文檔的建站神仙組合 Vercel + Docusaurus
個人部落格、開源文檔的建站神仙組合 Vercel + Docusaurus
個人部落格、開源文檔的建站神仙組合 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 的組合方案很不錯,讓有編寫個人靜态站點、文檔和部落格需求的你無需任何成本即可輕松搭建一個個人站點。