如何生成XWiki中指定页面的子页面列表？

其实{{children/}}宏本身就支持指定目标父页面，不用局限于当前页面，只需要给它加个reference参数就行，非常简单。

基础用法 #

直接在页面中插入带reference参数的宏，参数值填你要指定的父页面的完整名称（格式是「空间名.页面名」，比如Main.WebHome）：

{{children reference="Main.WebHome"/}}

这样就能列出Main.WebHome页面的所有直接子页面了。

进阶参数（让列表更符合需求） #

如果需要更定制化的展示，可以搭配这些常用参数：

• 控制层级深度：用depth参数设置要显示的子页面层级，比如depth="2"会显示直接子页面以及它们的子页面（共两层）：

  {{children reference="MyProject.ParentPage" depth="2"/}}
  

• 排序规则：用sort参数指定排序字段，支持按名称（name）、修改日期（date）、创建者（author）等排序，还可以加reverse="true"反转顺序：

  {{children reference="MyProject.ParentPage" sort="date" reverse="true"/}}
  

• 自定义显示内容：用display参数控制展示样式，比如display="title"只显示页面标题，display="compact"会显示标题加简短描述，display="full"则显示完整的页面摘要：

  {{children reference="MyProject.ParentPage" display="compact"/}}
  

小提示 #

如果不确定目标页面的完整引用名称，可以打开该页面，点击页面右上角的「页面信息」（或者在页面管理菜单里找），就能看到它的完整页面标识符，直接复制过来用就不会出错啦。

内容的提问来源于stack exchange，提问作者TheClassic