TMaker 快速开始
从安装到首个模板上线
用最短路径了解 TMaker 的初始化、构建、渲染与预览工作流。
1
安装 TMaker
先确认 CLI 可在仓库根目录运行。
所有 tmaker 命令都需要在包含 templates/ 与 config.json 的仓库根目录执行。
tmaker --version
tmaker template list小贴士
- • 先在仓库根目录执行命令
- • 建议确认可见模板列表后再开始新模板工作
2
初始化模板目录
创建标准化模板结构。
tmaker init mysite
cd templates/mysite
npm install
npm run build
cd ../..- pages/ 存放服务端渲染页面模板
- components/ 组织布局与自定义组件
- css/site.css 与 js/site.js 分别负责样式和轻量交互脚本
3
创建页面与数据
用 Scriban 与 JSON 组织模板输出。
templates/mysite/pages/index.sbn
templates/mysite/pages/index.data.json页面模板只写 body 内容，数据文件直接定义页面数据，渲染时通过 post.xxx 访问。
小贴士
- • 避免创建任何 .meta.json
- • 页面命名与数据文件命名保持一致
4
渲染与预览
生成 HTML 并在本地验证页面结果。
tmaker render mysite
tmaker preview mysite如需仅调试某一页，可使用 -p 只渲染目标页面。
小贴士
- • 模板目录内修改 CSS/JS 后先 npm run build
- • 页面内容修改后重新执行 render 即可
继续深入
熟悉基础流程后，建议继续查看以下内容。