xiis模板开发与智能链接URL生成规则

xiis模板开发与智能链接URL生成规则

1024KB1024KB 使用手册 2026-10-07 10:30:00 浏览 63213 字数 1245

模板开发围绕模板目录、页面模板与链接规则三块展开:每个页面由对应模板文件渲染,公共部件通过载入标签复用,URL 形态由站点配置驱动。模板中一律用智能链接字段输出地址,站点调整链接策略后模板无需修改。

模板目录与页面模板

前台模板存放在站点的模板目录下,一个模板由一组页面文件组成:首页、栏目列表页、内容详情页、单页、标签详情与汇总页、搜索结果页、错误页以及公共部件。单页模板以单页代码命名即可自动匹配,公共部件通过载入标签引入,头部与页脚各自独立维护。

模板支持后台切换与上传:站点可以在多套模板之间切换,切换只影响渲染选择,不改变内容数据;域名管理中指定的模板路径决定站点使用哪一套模板,多站点可以共享同一套模板文件,也可以各自独立维护。

单页模板的选择优先级

单页渲染按固定优先级选择模板:页面记录的模板字段优先,其次按单页代码匹配同名文件,再回退通用页面模板与关于模板。把模板文件命名为单页代码是推荐的对接方式,新增单页时不需要在后台配置模板路径。

模板复用与输出缓存

公共部件用载入标签复用,头部样式与脚本统一由部件引入并携带版本参数;页面渲染结果进入输出缓存并预压缩,高并发访问时显著降低渲染开销。模板内禁止行内样式与行内事件,样式进统一样式表、逻辑进统一脚本文件,这是项目长期执行的工程约定。

输出缓存与模板缓存是两级加速:模板缓存保存解析结果,输出缓存保存渲染结果,两级都命中时页面几乎只剩网络耗时;内容发布后相关缓存按站点的缓存策略失效或等待过期,调整缓存时长前先确认站点的内容更新频率。

智能链接与 URL 生成规则

URL 形态由站点配置驱动:别名开关决定栏目与内容链接使用别名形态还是编号形态,标签另有独立开关;后缀配置为动态链接追加统一后缀,已含后缀的链接不重复追加;路由前缀配置决定栏目页、内容页、标签页与用户中心的路径前缀,部分前缀修改后需要重启服务生效。

配置键作用
别名开关链接使用别名或编号形态
后缀配置为动态链接追加统一后缀
路由前缀决定各类页面的路径前缀

搜索页的关键词参数名可配置,默认使用单字母参数并兼容旧参数名;标签分页支持两种形态,路径式对搜索引擎更友好,查询串式兼容旧行为,两者对模板写法没有影响。

链接字段的选型

模板中输出链接有三种形态:编号形态、别名形态与智能形态。智能形态按配置自动选择,是唯一推荐用法;别名形态在别名为空时回退编号;编号形态仅在特殊调试场景使用。栏目、内容、标签与导航都提供对应的字段,写法前缀与所在循环匹配。

多站点注意

  • 套用模板到新站点时,先确认该站点的链接配置与模板假设一致
  • 路由前缀修改属于低频高影响操作,变更后重启服务再验证链接
  • 单页模板命名与单页代码保持一致,避免回退到通用模板

模板与链接规则的关系可以概括为:模板描述结构,链接字段负责地址。智能链接字段把地址形态的选择交给站点配置,模板因此可以在多个站点之间复用,切换站点时只需核对配置;多站点共用模板时,链接配置是唯一的适配点。

分享到:

评论

加载中...
我
还没有评论,快来抢沙发吧~