模板开发围绕模板目录、页面模板与链接规则三块展开:每个页面由对应模板文件渲染,公共部件通过载入标签复用,URL 形态由站点配置驱动。模板中一律用智能链接字段输出地址,站点调整链接策略后模板无需修改。
前台模板存放在站点的模板目录下,一个模板由一组页面文件组成:首页、栏目列表页、内容详情页、单页、标签详情与汇总页、搜索结果页、错误页以及公共部件。单页模板以单页代码命名即可自动匹配,公共部件通过载入标签引入,头部与页脚各自独立维护。
模板支持后台切换与上传:站点可以在多套模板之间切换,切换只影响渲染选择,不改变内容数据;域名管理中指定的模板路径决定站点使用哪一套模板,多站点可以共享同一套模板文件,也可以各自独立维护。
单页渲染按固定优先级选择模板:页面记录的模板字段优先,其次按单页代码匹配同名文件,再回退通用页面模板与关于模板。把模板文件命名为单页代码是推荐的对接方式,新增单页时不需要在后台配置模板路径。
公共部件用载入标签复用,头部样式与脚本统一由部件引入并携带版本参数;页面渲染结果进入输出缓存并预压缩,高并发访问时显著降低渲染开销。模板内禁止行内样式与行内事件,样式进统一样式表、逻辑进统一脚本文件,这是项目长期执行的工程约定。
输出缓存与模板缓存是两级加速:模板缓存保存解析结果,输出缓存保存渲染结果,两级都命中时页面几乎只剩网络耗时;内容发布后相关缓存按站点的缓存策略失效或等待过期,调整缓存时长前先确认站点的内容更新频率。
URL 形态由站点配置驱动:别名开关决定栏目与内容链接使用别名形态还是编号形态,标签另有独立开关;后缀配置为动态链接追加统一后缀,已含后缀的链接不重复追加;路由前缀配置决定栏目页、内容页、标签页与用户中心的路径前缀,部分前缀修改后需要重启服务生效。
| 配置键 | 作用 |
|---|---|
| 别名开关 | 链接使用别名或编号形态 |
| 后缀配置 | 为动态链接追加统一后缀 |
| 路由前缀 | 决定各类页面的路径前缀 |
搜索页的关键词参数名可配置,默认使用单字母参数并兼容旧参数名;标签分页支持两种形态,路径式对搜索引擎更友好,查询串式兼容旧行为,两者对模板写法没有影响。
模板中输出链接有三种形态:编号形态、别名形态与智能形态。智能形态按配置自动选择,是唯一推荐用法;别名形态在别名为空时回退编号;编号形态仅在特殊调试场景使用。栏目、内容、标签与导航都提供对应的字段,写法前缀与所在循环匹配。
模板与链接规则的关系可以概括为:模板描述结构,链接字段负责地址。智能链接字段把地址形态的选择交给站点配置,模板因此可以在多个站点之间复用,切换站点时只需核对配置;多站点共用模板时,链接配置是唯一的适配点。
评论
加载中...