模板开发指南

一套主题需要哪些文件

template/mytheme/
├── index.html      首页
├── lists.html      栏目列表
├── detail.html     内容详情
├── page.html       单页
├── search.html     搜索
├── message.html    询盘页
├── 404.html        404
├── theme.json      主题信息
└── comm/           公共片段（head / header / footer / 表单）

静态资源放在 public/template/mytheme/ 下，模板里用 /template/{$theme}/css/style.css 引用。

theme.json

{
  "name": "My Theme",
  "version": "1.0.0",
  "author": "Your Name",
  "description": "适合机械行业的外贸主题",
  "thumb": ""
}

没有 theme.json 的目录不会出现在后台的主题下拉框里。

取数据

列表：{tw:list sort="$sort.id" limit="12" page="$tw_page"}，循环里用 {$list.title}、{$list.url}、{$list.ico}、{$list.summary}、{$list.date}。

导航：{tw:nav parent="0" limit="8"}，循环里用 {$nav.name}、{$nav.url}、{$nav.active}。

调试

• 改完模板如果没变化，先清后台「SEO 工具 → 静态化缓存」
• 模板编译缓存放在 runtime/ 下，删掉会自动重建
• 报错页会显示具体模板文件与行号

注意事项

• 模板文件名不要和栏目 slug 冲突
• 不要在模板里直接写 SQL，统一走标签
• 保留页脚版权链接，其余随意改