网站使用 vuepress 和 vuepress-theme-plume 构建生成。
npm i# 启动开发服务 npm run docs:dev # 构建生产包 npm run docs:build # 本地预览生产服务 npm run docs:preview # 更新 vuepress 和主题 npm run vp-update主题已创建 github actions: .github/workflows/docs-deploy.yml,你还需要在 github 仓库中进行以下设置:
-
settings > Actions > General,拉到页面底部,在Workflow permissions下,勾选Read and write permissions,并点击保存按钮 -
settings > Pages, 在Build and deployment中,Source选择Deploy from a branch,Branch选择gh-pages,并点击保存按钮 (首次创建可能没有gh-pages分支,你可以先完成上面的设置后,推送一次代码到主分支,等待github actions完成后再进行设置) -
修改
docs/.vuepress/config.ts中的base选项:- 如果你准备发布到
https://<USERNAME>.github.io/,你可以省略这一步,因为base默认就是"/"。 - 如果你准备发布到
https://<USERNAME>.github.io/<REPO>/,也就是说你的仓库地址是https://github.com/<USERNAME>/<REPO>,则将base设置为"/<REPO>/"。
- 如果你准备发布到
如需要自定义域名,请查看 Github Pages 文档