Skip to content

模板引擎 ​

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)。

资源关系 ​

LayoutPage站点资源"head: CDN / importmap / 全局 Style""k-placeholder 占位区""layout id 引用 Layout""placeholder 注入各占位区""view id 引用 View""内联 script / 页面级逻辑"View 片段Script .js 路由Style .css 路由
资源典型职责是否有 URL 路由
Layout整页骨架、k-placeholder否
Page路由页面、选择布局、填占位是
ViewHeader、卡片、列表等复用块否
Script可 import 的 JS、前端交互是
Style全局或页面样式表是

文档导航 ​

主题说明
Layoutk-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/metak.page

数据查询 ​

  • k-data — 声明式数据(let / query / map / export)
  • 历史 k-query 已弃用;旧 URL 会重定向到 k-data