为 ZKEACMS 设计的模板开发工具,使用 LiquidJS 进行模板渲染和管理。
Templiq 是一个专门为 ZKEACMS 内容管理系统开发的模板创建和打包工具。它允许开发者创建可扩展的 Widget 模板,这些模板可以直接安装到 ZKEACMS 中使用。
- 📝 模板创建 - 快速创建新的网页组件模板
- 👁️ 实时预览 - 在线预览模板渲染效果
- 📦 打包上传 - 将模板打包为
.wgt文件并上传到云存储 - 🎨 多种设计 - 内置多种精美的网页设计模板
npm install安装完成后,需要初始化 Playwright 浏览器:
npx playwright install或者只安装 Chromium(推荐):
npx playwright install chromium创建 .env 文件(参考 .env.example)并配置以下环境变量:
PORT=3000
B2_APPLICATION_KEY_ID=your_b2_key_id
B2_APPLICATION_KEY=your_b2_application_key
B2_BUCKET_NAME=your_b2_bucket_name
npm run dev服务器将在 http://localhost:3000 启动。
npm start- 启动服务器npm run dev- 开发模式启动npm run build- 编译 TypeScriptnpm test- 运行测试npm run new- 创建新的模板npm run pack- 打包模板npm run upload- 上传模板
├── src/
│ ├── app.ts # 主应用文件
│ ├── data/ # 模板数据和 Schema 定义文件
│ ├── designs/ # 设计源文件 (HTML/CSS/JS)
│ ├── public/ # 静态资源
│ ├── templates/ # Liquid 模板文件
│ └── tools/ # 工具脚本
├── output/ # 打包输出目录 (.wgt 文件)
└── package.json
每个模板包含三个核心文件:
- Liquid 模板 (
src/templates/section-{id}.liquid) - 模板渲染逻辑 - 数据文件 (
src/data/section-{id}.json) - 模板示例数据 - Schema 定义 (
src/data/section-{id}.def.json) - 字段定义
SingleLine- 单行文本Paragraph- 段落文本HtmlBox- HTML 编辑器Address- 地址字段Checkbox- 复选框Radio- 单选框Date- 日期选择Dropdown- 下拉选择Email- 邮箱输入Number- 数字输入Phone- 电话输入Media- 媒体上传Array- 数组字段
打包后的 .wgt 文件是一个 gzip 压缩的 JSON 包,包含:
- Widget 配置信息
- Liquid 模板文件
- 缩略图图片
- 媒体资源文件
- Node.js + Express
- TypeScript
- LiquidJS (模板引擎)
- Playwright (截图)
- Sharp (图像处理)
- Backblaze B2 (云存储)
MIT