将页面树宏添加到页面以显示空间中页面的全部或部分层次结构。

这个宏非常适用于:

  • 如果页面在一个父页面下组织在一起,则可以快速轻松地找到项目中的某个页面
  • 以类似目录的方式帮助人们浏览一组相关页面
  • 文档空间中按层次结构显示页面概览

截图:Confluence中的页面树宏显示了两级层次结构。


在页面中添加宏

在页面中添加Page Tree宏:

  1. 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)
  2. Confluence content类别中选择Page Tree
  3. 设置一些参数(详见下文)。
  4. 点击Insert

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

截图:配置页面树宏以在另一个空间中显示指定页面下方的所有页面。

修改宏参数

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

要更改宏参数:

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

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

参数

默认值

描述

Root Page
(root

The home page of the space

指定页面树的父页面(根页面)。该树将包括给定页面的所有子页面,以及它们的子页面和所有下级页面等。该树将不包括根页面本身。

指定页面标题或特殊值,如下所示:

  • Your page title — 为页面树指定的父页面或根页面名称。该树将包括指定页面的所有子节点和下级节点。该树将不包括指定的根页面本身。
  • '@home' — 将包括空间主页下的所有页面(默认)。
  • '@self' — 将包括当前页面下的所有页面。
  • '@parent' — 将包括当前页面的父页面下的所有页面,包括当前页面。
  • '@none' — 将包括空间中的所有页面,包括孤立页面和主页。
Restrict to this space keyCurrent space

输入空间名称以显示不同空间的页面树。留空表示使用当前空间。

如果您打算在另一个空间中指定一个根页面,请在设置Root Page之前设置此参数。

Sort Pages By
(sort

position

指定在树中显示页面的顺序。此排序顺序仅用于显示目的。它不会重新排列页面顺序。该值可能是以下之一:

按位 — 按字母顺序排序,例如:title1、title10、title2。
创建 - 按创建日期排序。
修改 - 按上次修改日期的顺序排序。
natural — 按“自然”字母顺序排序,例如:title1、title2、title10。
位置 — 按默认的 Confluence 排序规则排序。 如果您的页面是手动排序的,则这种排序将遵循定义的顺序。 否则页面将按“自然”字母顺序显示,例如:title1、title2、title10。

  • bitwise — 按字母顺序排序,例如:title1、title10、title2。
  • creation — 按创建日期排序。
  • modified — 按上次修改日期的顺序排序。
  • natural — 按“自然”字母顺序排序,例如:title1、title2、title10。
  • position — 按默认的Confluence排序规则排序。如果您的页面是手动排序的,则这种排序将按照设定的顺序。否则页面将按“自然”字母顺序显示,例如:title1、title2、title10。

Include Excerpts in Page Tree
(excerpt

false

选择是否希望页面树显示每个页面的摘要。摘要必须由Confluence Excerpt Macro(摘要宏)在每个页面上设定。

Reverse Order
(reverse

false

勾选表示按倒序(降序)显示页面。必须与Sort Pages By参数结合使用。

Include Search Box above Page Tree
(searchBox

false

选择是否要在页面树上方包含搜索框。搜索框允许您的读者在页面树中进行搜索。

Show Expand/Collapse Links
(expandCollapseAll

false

选择是否要在页面树的顶部显示“全部展开”和“全部折叠”链接。您的读者可以单击这些链接一次打开或关闭树的所有分支。

wiki标记和存储格式中的可用值:

  • true – 显示“全部展开”和“全部折叠”选项。
  • false – Do not show the options.

Start Depth
(startDepth

1

输入任何大于0的数字以设置树首次打开时应显示的层级数。

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

其它添加方式

用键盘输入添加宏

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

通过wiki标记添加宏

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

Macro name: pagetree

Macro body: None.

{pagetree:root=Page Name|sort=natural|excerpt=true|reverse=false|startDepth=3|expandCollapseAll=true|searchBox=true}
CODE