函数的定位
主题模板通过函数从 CMS 获取栏目、内容、标签等数据,并组合渲染页面。建议:先统一封装/约定调用方式,再做页面层拼装。
1. 常见数据调用(示例)
# 取某栏目最新 N 条
{{ $list := ColumnContents "guie" 8 }}
# 取相关内容(示例)
{{ $rel := Related .Single 6 }}
# 取栏目树/导航
{{ range .Columns }} ... {{ end }}
2. 参数约定
- slug:优先传栏目 slug(不要在模板里写死 column_id)
- limit:列表条数固定在模板层,避免一次取太多
3. 渲染注意事项
- 字段可能为空:标题/封面/摘要/标签,需要做兜底
- HTML 内容:注意输出时的安全策略(按系统默认的 safe HTML 机制)
- 性能:不要在一个页面里对同一栏目重复多次查询(可用临时变量缓存)
4. 建议的函数清单
你可以按“栏目列表/文章详情/标签聚合/文档模式”四类页面整理函数调用与数据结构,形成主题开发的内部约定。