快速开始

5分钟创建你的第一个 TMaker 模板

1

安装 TMaker

选择适合你系统的安装方式

TMaker 提供多种平台的预编译二进制包，选择适合你系统的版本进行安装。

# 使用 curl 一键安装 (推荐)
curl -fsSL https://minio.feinian.net/devops/aicms/tmaker/2025/tmaker-0.1.1-linux-x64.tar.gz | tar -xz -C /usr/local/bin

# 验证安装
tmaker --version
# 使用 curl 一键安装 (推荐)
curl -fsSL https://minio.feinian.net/devops/aicms/tmaker/2025/tmaker-0.1.1-macos-x64.tar.gz | tar -xz -C /usr/local/bin

# 验证安装
tmaker --version
# 使用 curl 一键安装 (推荐)
curl -fsSL https://minio.feinian.net/devops/aicms/tmaker/2025/tmaker-0.1.1-macos-arm64.tar.gz | tar -xz -C /usr/local/bin

# 验证安装
tmaker --version
# 使用 PowerShell 下载安装
Invoke-WebRequest -Uri 'https://minio.feinian.net/devops/aicms/tmaker/2025/tmaker-0.1.1-windows-x64.zip' -OutFile tmaker.zip
Expand-Archive -Path tmaker.zip -DestinationPath "$env:LOCALAPPDATA\tmaker"
$env:Path += ";$env:LOCALAPPDATA\tmaker\tmaker-windows-x64"

# 验证安装
tmaker --version
# 使用 DEB 包安装
wget https://minio.feinian.net/devops/aicms/tmaker/2025/tmaker_0.1.1_amd64.deb
sudo dpkg -i tmaker_0.1.1_amd64.deb

# 验证安装
tmaker --version

**手动安装（Linux/macOS）**

# 1. 下载压缩包
wget https://minio.feinian.net/devops/aicms/tmaker/2025/tmaker-0.1.1-linux-x64.tar.gz

# 2. 解压
tar -xzf tmaker-0.1.1-linux-x64.tar.gz

# 3. 移动到系统路径
sudo mv tmaker /usr/local/bin/
sudo mv appsettings.json /usr/local/bin/
sudo chmod +x /usr/local/bin/tmaker

# 4. 验证安装
tmaker --version

**手动安装（Windows）**

1. 下载 ZIP 文件并解压到任意目录（如 `C:\Program Files\TMaker`） 2. 将解压目录添加到 PATH 环境变量 3. 打开新的终端窗口验证安装：`tmaker --version`

💡 小贴士

  • • 安装后需要重启终端以使命令生效
  • • 可以使用 `mk` 作为 `tmaker` 的简写命令
  • • 当前版本：0.1.1 (2025)
  • • 更多下载选项请访问 [安装页面](/install.html)
2

初始化新模板

使用 init 命令创建标准模板结构

# 进入 TMaker 目录
cd TMaker

# 初始化新模板（假设模板 ID 为 mysite）
tmaker init mysite

# 或使用简写
mk init mysite

init 命令会创建以下文件结构：

templates/mysite/
├── template.json          # 模板配置文件
├── pages/                 # 页面目录
├── components/            # 组件目录
│   └── layout/           # 布局组件
├── css/
│   └── site.css          # Tailwind CSS 配置
├── js/
│   └── site.js           # Alpine.js 和自定义脚本
├── tailwind.config.js    # Tailwind 配置
└── package.json          # 依赖配置

💡 小贴士

  • • 模板 ID 只能包含字母、数字、下划线和连字符
  • • 建议使用有意义的名称，如 corporate, blog, ecommerce 等
3

安装依赖

安装 Tailwind CSS 和其他前端依赖

# 进入模板目录
cd templates/mysite

# 安装依赖
npm install

# 返回 TMaker 目录
cd ../..

💡 小贴士

  • • 首次运行需要安装 Node.js 和 npm
  • • 推荐使用 Node.js 18 或更高版本
4

创建首页

创建第一个页面模板和数据文件

在 `templates/mysite/pages/` 目录下创建 `index.sbn`：

{{~ # Hero Section ~}}


  

    
{{ post.heroTitle }}

    
{{ post.heroSubtitle }}

    
      {{ post.ctaText }}
    
  




{{~ # Features Section ~}}


  

    
{{ post.featuresTitle }}

    

      {{~ for feature in post.features ~}}
      

        
{{ feature.icon }}

        
{{ feature.title }}

        
{{ feature.description }}

      

      {{~ end ~}}

创建对应的 `index.data.json`：

{
  "heroTitle": "欢迎使用 TMaker",
  "heroSubtitle": "AI 驱动的智能模板设计器",
  "ctaText": "立即开始",
  "ctaUrl": "/docs/index.html",
  "featuresTitle": "核心特性",
  "features": [
    {
      "icon": "🚀",
      "title": "快速开发",
      "description": "使用 AI 快速生成完整网站模板"
    },
    {
      "icon": "🎨",
      "title": "现代设计",
      "description": "基于 Tailwind CSS v4 的现代化设计"
    },
    {
      "icon": "⚡",
      "title": "高性能",
      "description": "静态生成，快速加载，SEO 友好"
    }
  ]
}

创建页面元数据文件 `index.meta.json`：

{
  "id": "home",
  "name": "首页",
  "description": "网站首页 - 展示产品特性和核心价值",
  "order": 1
}

💡 小贴士

  • • .sbn 文件只包含 body 内容，不需要 HTML 头部
  • • 数据文件中的属性使用小驼峰命名（camelCase）
  • • 在模板中通过 post.xxx 访问数据
  • • 每个页面必须有对应的 .meta.json 文件
5

渲染预览

渲染模板并启动预览服务器

# 确保在 TMaker 目录下
cd TMaker

# 渲染模板
tmaker render mysite

# 启动预览服务器
tmaker preview mysite

# 或合并为一行
mk render mysite && mk preview mysite

打开浏览器访问 `http://localhost:1688` 即可查看效果。

💡 小贴士

  • • 修改模板后需要重新运行 render 命令
  • • 可以使用 -p 参数指定端口：`mk preview mysite -p 3000`
  • • preview 命令会自动打开浏览器
6

使用 AI 生成

（可选）使用 AI 自动生成完整网站

配置 Claude API 密钥到 `appsettings.json`：

{
  "Claude": {
    "ApiKey": "your-claude-api-key",
    "Model": "claude-sonnet-4-20250514"
  }
}

使用 AI 生成命令：

# 生成完整网站
tmaker ai-generate mysite

# 或使用简写
mk ai mysite

AI 会根据 `template.json` 中的配置自动生成所有页面内容。

💡 小贴士

  • • 需要有效的 Claude API 密钥
  • • AI 生成会根据模板配置自动创建页面
  • • 可以使用 --force 参数强制重新生成所有页面

下一步

恭喜！你已经完成了第一个 TMaker 模板。接下来可以：

📚

深入学习 TMaker 命令

了解所有可用的 CLI 命令和选项
🏗️

探索模板结构

理解模板的目录结构和文件组织
💡

学习 Scriban 语法

掌握强大的 Scriban 模板语言
🧩

使用组件系统

创建可复用的组件提高开发效率

常见问题

❓ 命令未找到：tmaker

请确保已正确安装 TMaker 并重启终端。Windows 用户可能需要重启计算机。

❓ 渲染失败：找不到模板文件

确保在 TMaker 目录下运行命令（不是 templates/mysite 目录）。

❓ 预览页面样式不正常

检查是否已在模板目录下运行 npm install 安装依赖。

❓ 页面数据未显示

确保 .data.json 文件名与 .sbn 文件名一致，且 JSON 格式正确。

遇到其他问题？

联系支持