开发与部署流程

开发与预览流程

在本地创建模板目录：在项目模板根目录（如 templates）下新建子目录，按快速开始写好 config.yaml、layout.html、home.html 及可选 routes.yaml、static/ 等。
启动后端：确保后端已启动并加载了模板根目录，新模板会被自动扫描并出现在「首页模板」列表中。
切换模板：在 系统管理 → 运维监控 → 系统配置 → 首页模板 中选择新模板并保存。
访问根路径：在浏览器访问站点根路径（非 /app 等管理后台路径），即可看到当前所选模板。修改模板文件后，根据是否支持热加载，可能需要刷新页面或重新选择模板以查看效果。
预览图：在模板目录下放置 preview.png（或 config 中填写的文件名），在后台模板选择界面会显示该预览图。

上传与多环境部署

文件系统优先：模板引擎会优先从模板根目录（如项目下的 templates）读取模板，因此将新模板目录放入该目录即可被识别。
生产环境：可通过挂载卷或拷贝方式，将开发好的模板目录部署到服务器上的模板根目录，无需重新编译；在后台切换即可生效。
若产品支持「上传模板压缩包」功能，可在系统配置的首页模板 Tab 中上传 zip（需包含 config.yaml、layout.html 及至少一个页面），系统解压到模板目录后即可在列表中选择。

注意事项小结

目录名即模板 ID：建议使用小写、数字、连字符，且同一模板根目录下不重复。
config.yaml 与 layout.html 必须存在，否则该目录不会被识别为有效模板。
至少有一个页面模板，且 home.html 或 index.html 会映射到根路径 /。
静态资源统一用 /home/static/...，与具体模板目录名无关。
多套模板并存时，注意不要覆盖已有模板目录；填写好 name、description、preview 便于运营在后台区分和选择。