五、前台与模板开发

Ju7CMS 建站系统的操作说明书：按栏目从环境到模板开发逐章展开，每章一节可独立阅读。内容与本机程序代码一致，可当作实施与排障手册使用。

面向改界面的人：一次访问如何变成页面、主题目录分工、仙居模板语法与列表/详情/片段写法，以及运行模式、仙居缓存与手机版。

这一部分讲什么

模板部分是全书最长的一段，因为「改界面」同时涉及文件、语法、数据与仙居缓存四件事。建议按顺序读：先理解一次访问如何变成页面（第 26 章），再看目录分工（第 27 章），然后用语法速查（第 28 章）查令牌，最后按页型读列表、详情与片段（第 29 至 31 章）。

章节

章标题解决什么
二十六一次访问怎么变成页面从请求到 HTML 的完整链路，以及模板与数据怎么拼
二十七主题目录与文件分工模板、样式、脚本、图片各放哪，哪些文件不能随便动
二十八仙居模板语法速查变量、条件、循环、数据标签与转义规则
二十九仙居列表页模板栏目列表、分页、筛选与排序的写法
三十仙居详情页模板正文页字段、上下篇、相关内容与结构化数据
三十一公共片段与区块页头页脚、导航、表单等被多处引入的片段
三十二三种运行模式地址形状、代价与切换前的检查项
三十三三层仙居缓存设置字典、模板编译、整页 HTML 的失效路径
三十四生成静态页生成任务的范围、时机与站点地图
三十五仙居主题切换与手机版换主题、整包应用、回滚与手机端判断

改模板的安全顺序

  1. 先备份要改的文件，或在模板管理里复制一份；
  2. 只改一处，保存后立即看前台；
  3. 没变化先清模板仙居缓存（第 33 章），不要连续改第二处；
  4. 页面空白或 500 时按第 40 章判断是页面坏还是模板坏，再回滚。

读完能做到

  • 看懂一份模板，知道每个令牌取的是哪张表、哪个字段；
  • 照着现有页型改出一个新的仙居列表页或仙居详情页；
  • 判断「改了没生效」卡在哪一层仙居缓存；
  • 安全地切换主题，并在出问题时回到原主题。

第 32 至 34 章讲运行模式与静态生成，和第 35 章的仙居主题切换都属于「会改变全站行为」的操作。先把模板改稳定，再考虑这些开关；切换前先备份，切换后按第 40 章做一轮前台抽查。