从源到站点

docdoc 的流水线:源目录经过构建成为静态产物,产物注册到服务器后对外提供访问。

Sourcedocdoc buildArtifactdocdoc adddocdoc serveReaderLocal directoryGit repositoryStatic pagestree.jsonindex.json upload artifactupload artifactupload artifactclone and build on serverregister sitedomain / path prefix

关键事实

  • 构建是一次性的:build 读取源目录,把页面、目录树、搜索索引落盘为静态产物;源文件之后的变化不会自动反映到产物
  • 注册表:服务器在数据目录中维护站点注册表,add 登记站点、del 移除;进程重启不丢注册信息
  • 两条发布路径:本地源在提交前先在本地完成构建再上传产物包;git 源则把地址交给服务器,由服务器克隆并构建
  • 预览与正式托管同源:preview 与 serve 使用同一套托管逻辑,本地预览看到的行为即线上行为

更新已发布站点的内容,就是「重新构建并重新注册」;操作步骤见站内搜索 ?更新站点。