将子页面宏添加到页面,可以按页面层级结构显示指定页面下的页面列表。您可以选择显示当前页面的子页面,或空间中任何其它页面的子页面。


这个宏适用于快速访问:

  • 与项目相关的页面 
  • 步骤或指引页面

因为它依赖于页面层级结构,所以在添加、删除或移动页面时会自动更新页面列表。它还可以显示页面摘要等更多内容。


截图:Children Display宏,显示有关打印机的页面列表。

在页面中添加Children Display宏

在页面中添加子页面宏:

  1. 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)
  2. Confluence contentNavigation类别中选择Children Display。
  3. 设置以下参数指定要显示的页面以及您希望它们呈现的效果。 
  4. 点击Insert。

然后,您可以发布您的页面以查看宏的效果。

截图:在子页面宏中指定父页面和显示选项。

  

修改宏参数

宏参数用于设置宏的行为。

要更改宏参数:

  1. 在编辑器中,点击宏占位符并选择“编辑(Edit)”。
  2. 根据需要设置参数,然后选择“插入(Insert)”。

这是此宏中可用的参数列表。

参数

默认值

描述

Show Descendants
(all

false

选择是否显示父页面的所有子页面。

如果为true,则显示父页面下方的完整页面树,而不管Depth of Descendants

Parent Page
(page

current

从当前空间或其它空间指定要显示其子页面的页面。 输入:

  • '/' — 列出当前空间的顶级页面,即那些没有父页面的页面。
  • 'pagename' — 列出指定页面的子页面。
  • 'spacekey:' — 列出指定空间的顶级页面。
  • 'spacekey:pagename' — 列出指定空间中指定页面的子页面。

Number of Children
(first

none

限制显示子页面的最大数量。

Depth of Descendants
(depth

none

Enter a number to specify the depth of descendants to display. For example, if the value is 2, the macro will display 2 levels of child pages.

This setting has no effect of Show Descendants is enabled.

输入一个数字以指定要显示的页面树的深度。例如,值为2时,将显示第一级和第二级子页面。

当启用Show Descendants时,此参数设置不生效。

Heading Style
(style

none

选择用于显示子页面的样式。

Include Excerpts
(excerpt

none

Allows you to include a short excerpt under each page in the list. Choose between:

允许您在列表中的每个页面下包含一个简短的摘要。选择:

无 - 不显示摘要
简单 - 
丰富的内容 - 显示摘要宏的内容,如果页面上没有摘要宏,则显示页面内容的第一部分,包括格式化文本、图像和一些宏。

  • None - 不显示摘要
  • Simple - 显示页面的摘要宏中包含的第一行文本。如果页面上没有摘要宏,则不会显示任何内容。
  • Rich content - 显示摘要宏的内容,如果页面上没有摘要宏,则显示页面内容的第一部分,可以包括文本、图片和一些宏。

Sort Children By
(sort

Manual if manually ordered, otherwise alphabetical

空白表示按当前页面树中的顺序显示页面。或者,选择:

  • creation — 按内容创建日期排序
  • title — 按标题的字符顺序排序
  • modified — 按最近修改日期排序

Reverse Sort
(reverse

false

Sort Children By参数一起使用。设置后,排序顺序从升序变为降序。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同,则会在参数名下方用括号列出,例如(example)。

其它添加方式

用键盘输入添加宏

输入左大括号{,然后输入宏名称的几个起始字符,就可以看到一个相关的宏列表。

通过wiki标记添加宏

当您想在编辑器之外添加宏时,这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。

Macro name: children

Macro body: None.

{children:reverse=true|sort=creation|style=h4|page=Home|excerpt=none|first=99|depth=2|all=true}
CODE