前言#
可能大家用 VuePress 做文檔的已經厭煩了每天對著終端敲 yarn docs:build 了吧。
想用 CI 卻苦於配置無從下手。
這裡我來和大家分享一下，如何將 VuePress 文檔部署到 Vercel 上。
本文僅適用於 VuePress v1 文檔。關於 v2 文檔，還請各位看官自行摸索。
步驟#
註冊 Vercel#
不多說了，這是註冊鏈接，推薦使用 GitHub 賬號進行 OAuth 登錄。
創建項目#
進入 Dashboard 以後，點擊右上角的 “New Project” 新建一個項目；
選擇你存放文檔的倉庫，點擊 “Import”，這裡用 PCL 生存服的文檔進行展示；
如果你要從一個組織賬號部署，你需要先創建一個團隊賬號。
FRAMEWORK PRESET 請務必選擇 Vue.js。
我們接下來來到 BUILD AND OUTPUT SETTINGS 頁面，打開第二個開關，在旁邊的文本框內填 .vuepress/dist（如果你的文檔在子目錄裡存放比如 docs 文件夾，那麼需要在前面加上這個文件夾的名字）。
其餘的可以留著不填，如下圖（請不要直接照抄）
點擊 “Deploy” 按鈕，然後等待部署。
如果頁面上冒出了煙花，表示你的文檔已經成功部署了。
配置項目#
打開項目，點擊 Settings，導航到 Git，將 “Production Branch” 設置為你存放文檔工作區的分支。
需要注意的是，文檔工作區的目錄結構一般長這個樣：
設置好，點擊 “Save”，然後對倉庫進行一次提交，更改就會自動部署到生產環境。
至此，我們所需要做的就全部完成了！