制作第一个 MacCMS 模板

创建 MacCMS 最小首页模板，输出站点名称和视频链接，启用模板并逐步检查结果。

本教程的结果是一张能显示网站名称和视频列表的首页。需要会创建文件和编辑 HTML；不需要先学完全部模板语法。先备份现有模板配置，使用本地测试站操作。

1. 创建目录

template/learn/html/index/index.html

learn 是模板名称，html 是模板文件目录，index/index.html 是全站首页。目录大小写必须一致。

2. 写入首页

<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>{$maccms.site_name}</title></head>
<body>
  <h1>{$maccms.site_name}</h1>
  <h2>最新视频</h2>
  {maccms:vod num="10" order="desc" by="time"}
    <p><a href="{:mac_url_vod_detail($vo)}">{$vo.vod_name}</a></p>
  {/maccms:vod}
</body>
</html>

本例只完成首页，点击视频链接需要对应详情模板。先确认首页输出正确，再从完整模板复制所需页面到测试主题；不要把这个最小主题直接用于正式站。

3. 后台启用

进入「系统 → 网站参数配置 → 基本设置」，模板选择／模板目录填写 learn，HTML 目录填写 html。保留原值的截图。保存并清理本站模板缓存，然后访问首页。

4. 你应该看到什么

h1 显示后台配置的网站名称，而不是字面量 {$maccms.site_name}。
如果已经发布视频，显示最多 10 条视频名称链接。
没有视频时列表为空。先按发布内容添加数据，不要先改查询代码。

理解三个常用对象

对象	含义	常见位置
$maccms	站点和页面信息	全站名称、当前模板路径
$vo	当前循环的一条记录	maccms:vod 内部
$obj	当前页面主对象	详情页是内容，分类页是分类

下一步：复用页头和页脚

新建 html/public/head.html，把重复的导航放进去，再在首页调用：

{include file="public/head" /}

不要让 head 再包含首页，避免循环包含。需要交互功能时使用对应版本的默认模板公共引入文件，确保 jQuery、程序变量、home.js 与 CSRF 令牌一起加载；只抄旧教程的三行脚本未必覆盖新功能。

完成后阅读目录约定、全局标签及模组参考。恢复原模板时填回之前的名称与 HTML 目录，清理本站模板缓存。