项目构建

由于使用了 vuepress 来构建最后的电子书发行,所以要使用 vuepress 的机制来操作,其中最需要注意的一点是章节导航栏的生成。

由于章节导航栏的配置被放在了 /Translation/.vuepress/config.js 里了,而且它是需要根据实际 md 文档的更新而更新的,所以写了一个脚本 /script/generateSideBar.js,每次构建之前执行一遍。

为了实现自动执行,在 package.json 中添加了一条预执行 script,这样只要执行 yarn docs:build 就可以自动构建完成了。

构建后的静态文件被保存在 /Translation/.vuepress/dist/ 下边。

静态站点的部署

这里选择了部署在 github pages 上边,为此又写了一个 /deploy.sh 脚本,每次执行完上边的构建之后,再执行根目录下这个部署脚本就可以自动更新内容了。

总结一下

每次编辑或者更新内容完成后,需要执行两条命令来实现构建和部署最新内容:

  1. yarn docs:build
  2. ./deploy.sh