模板引擎
Kooboo 站点前端:页面、布局、视图与静态资源如何组织与渲染
概述
在 Kooboo 中,可访问的 HTML 页面由 Page 定义;Layout 提供整站共用的 HTML 骨架(<head>、导航、占位区);View 是可复用的 HTML 片段;Script / Style 是带路由的独立 .js / .css 资源,供布局或页面引用。
k-content、k-for 等模板指令会自动在服务端求值;只有模板需要执行 KScript 时才使用 <script env="server">(见 模板绑定语法)。声明式数据查询使用 k-data(替代已弃用的 k-query)。
资源关系
| 资源 | 典型职责 | 是否有 URL 路由 |
|---|---|---|
| Layout | 整页骨架、k-placeholder | 否 |
| Page | 路由页面、选择布局、填占位 | 是 |
| View | Header、卡片、列表等复用块 | 否 |
| Script | 可 import 的 JS、前端交互 | 是 |
| Style | 全局或页面样式表 | 是 |
文档导航
| 主题 | 说明 |
|---|---|
| Layout | k-placeholder、多栏布局 |
| Page | 独立页 vs <layout> + <placeholder> |
| View | <view id="...">、拆分原则 |
| Script | 站点 JS 资源、type="module" |
| Style | 站点 CSS、与 Tailwind 等配合 |
| 模板绑定语法 | <script env="server">、k-content、k-for 等 |
| k-data | <k-data>、<query>、JSON5 条件 |
与 KScript API 的分工
| 场景 | 文档位置 |
|---|---|
| 在 HTML 模板 里写布局、占位、视图引用 | 本目录 templateEngine/* |
用 k.site.pages 等 脚本 增删改资源 | k.site |
输出 站点导航菜单(<menu> 或 k.site.menus + k-for) | k.site.menus · CMS:菜单 |
| 调用 外部 OpenAPI 服务 | k.openApi · CMS:Open API |
| SPA 前端拉取 JSON 词典 | SPA 多语言 API · CMS |
| 可安装模块(路由、view/api) | k.module · CMS:模块 |
| 定时任务 | k.site.runJob · CMS:定时任务 |
| 改 当前请求 的 title/meta | k.page |
数据查询
- k-data — 声明式数据(
let/query/map/export) - 历史
k-query已弃用;旧 URL 会重定向到 k-data