站点发布

快速上手 一节中介绍了如何快速搭建站点, 本节将介绍如何将搭建好的站点打包、发布到 gh-pages。

自动打包发布到 gh-pages (推荐)

初始化的模板项目集成了 Github actionci 配置, 使用方只需在 main 分支执行 git push 即可以完成站点的自动部署。

如果是第一次部署, 在执行以下操作后, 需要在项目的 setting 选项卡中将 Github Pages 选择为 gh-pages。(详情见 First Deployment with GITHUB_TOKEN)

git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/用户或组织名/项目名.git
git push -u origin main

手动打包发布

如果需要发布到自定义服务器, 可以执行 npm run build 或者 yarn build 对将要发布的文档站点进行打包构建, 此时的文档网站已准备好进行部署。

接着将打包出的 .crd-dist 的文件资源同步到目标服务器即可。