xiis全局标签在站点信息与统计场景的用法

xiis 的全局标签覆盖站点信息、内容统计、分页导航与页面上下文四类场景，是模板中出现频率最高的一类标签。这类标签以单值替换的形式工作，直接写在页面任何位置即可输出结果，不需要循环包裹，也不依赖所在页面类型。

站点信息类标签的取值来源

站点信息类标签从站点配置表与模板变量表中取值，包括网站标题、网站关键词、网站描述、网站地址、网站标志、网站邮箱与网站电话。这些配置全部在后台维护，模板引用的是键名而不是写死的文本，站点改名或更换联系方式时模板无需改动。

• {xiis:网站标题} 输出站点名称，常用于标题区域与页头品牌位
• {xiis:网站关键词} 与 {xiis:网站描述} 供搜索引擎的 meta 信息使用
• {xiis:备案号} 与 {xiis:公安备案} 输出备案信息，适合放在页脚
• {xiis:统计代码} 输出统计平台脚本，未配置时保持为空

统计类标签的计数口径

统计类标签输出站点维度的聚合数字：内容总数、栏目总数、标签总数、用户总数与单页总数。所有统计均按站点隔离，不会把其他站点的数据混入，多站点共用模板时各站输出各自的数据。

标签总数有专门的口径：只统计自身启用且至少被一条已发布内容引用的标签。内容从已发布改为草稿后，其独占标签会随之从计数中移除，标签总数因此随内容发布状态实时变化，与内容总数的统计口径保持一致，避免出现标签云列出某标签而使用次数为零的矛盾。

内容总数同样只统计已发布且未删除的内容，草稿与待审核内容不计入。模板作者把统计标签与列表标签放在同一页面时，两者口径一致，页面上的数字与列表条数能够对得上。

分页与搜索上下文标签

搜索页与分页场景有一组上下文标签，输出当前请求的关键词与页码信息：搜索关键词、搜索总数、当前页码、总页数与每页数量。它们与搜索分页、栏目分页配合，构成完整的列表分页体验。

栏目分页标签支持页码数量、显示项、上一页文字、下一页文字、信息文字等参数，可以按站点风格定制分页外观；在标签详情页中，同一标签会自动识别页面类型，输出指向当前标签的分页链接，模板无需为标签页单独编写分页代码。

导航与页面分类标签

{xiis:当前位置} 根据页面上下文自动生成面包屑：内容详情页输出分类链加标题，栏目列表页输出父分类链加当前分类。页面分类相关的全局标签用于筛选栏与导航高亮，其中归属链接与归属激活两个标签与页面分类列表的回退规则严格一致，分类页全部按钮的链接与高亮可以直接引用它们。

页面激活标签用于导航高亮，判断当前页面标识是否等于指定值，写法上支持行内三元语法，与导航列表循环配合即可输出带高亮状态的菜单。

配置项与模板变量标签

除内置标签外，站点配置表的配置键与模板变量表的变量名也可以直接用标签输出：{xiis:route_tag} 输出路由前缀，{xiis:site_slogan} 输出站点口号。查找顺序为标签注册表、系统配置表、模板变量表，均未命中时原样保留，取值按站点隔离。敏感键（密钥、密码、令牌等）会被安全校验拦截，模板中引用这类键不会输出内容。

使用要点

• 全局标签可以写在页面任何位置，包括 HTML 属性值中
• 站点信息与统计类标签按站点自动隔离，无需在模板里区分站点
• 统计数字与内容发布状态联动，后台批量改状态后数字随之变化
• 配置项标签在未配置时输出为空而不是报错，缺内容优先查配置

这类标签的定位是把站点与页面的上下文塞进模板：站点信息、统计数字、分页上下文、导航位置都由它承担。理解每类标签的取值来源与计数口径后，模板调试就不再依赖猜测——数字不对先查口径，值为空先查配置，位置不对先查页面上下文。