Confluence 页面树（Page Tree）宏

页面树（Page Tree）宏在页面中显示页面的继承情况。这个从你指定的页面开始显示页面树，默认是从根页面（root）开始的。页面树可以作为内容列表或者主题列表。

当你查看页面树的时候，你可以随机单击页面树中的链接来链接到其他页面。当前页面在页面树结构中的位置是会被高亮显示的。

注意： 页面树在 Confluence 文件主题中常常被用于构造一个导航面板来显示你空间的内容列表。 请参考文档主题页面中有关说明。

使用页面树（Page Tree）宏

希望在页面中使用页面树（Page Tree）宏：

1. 打开你希望编辑 Confluence 页面，然后单击 编辑（Edit）按钮。页面的编辑模式将会被打开。
2. 下一步，在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
3. 在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击 插入（insert）来将需要的宏插入到页面中。

在宏浏览器中单击 刷新（Refresh）按钮来让设置的宏参数生效。

参数

宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(example)。

参数	默认值	说明
Root Page (root)	空间的主页	指定页面树的上级页面。页面树宏将会包含所有给定页面的子页面和子页面的子页面，一直到没有子页面位置。页面树将不会显示作为根页面给定的页面。 指定页面的标题或者下面给定的值： 你页面的标题 — 为页面树的父页面或者根页面来指定页面的名字。页面树宏将会包含所有给定页面的子页面和子页面的子页面，一直到没有子页面位置。页面树将不会显示作为根页面给定的页面。 '@home' — 将会显示给定空间的的所有页面树，从根目录开始（这个是默认值）。 '@self' — 包含从当前页面向下的页面。 '@parent' — 包含从当前页面向上的页面作为根页面的页面树。 '@none' — 将会包含空间中的所有页面，包括没有链接的页面和首页。
页面排序方式（Sort Pages By） (sort)	position	在页面树中指定页面的排序方式。这个排序方式仅仅是在显示的时候使用的，这个排序不会对页面的实际存储顺序产生影响。你可以使用下面的一些值： bitwise — 按照字符方式进行排序，例如： title1, title10, title2。 creation — 按照创建的日期进行排序。 modified — 按照最后修改的日期进行排序。 natural — 使用字符自然（natural）排序，例如： title1, title2, title10。 position — 使用 Confluence 使用的默认排序规则。如果你的页面被设置手动排序，这个排序方式将会被默认使用。否则页面将会使用使用字符自然（natural）排序，例如： title1, title2, title10。
在页面树中包含摘要（Include Excerpts in Page Tree） (excerpt)	false	如果你希望在页面树中为页面显示摘要，你需要选择这个。摘要在页面中需要有定义，请参考 摘要（Excerpt）宏 中的相关说明。
逆向排序（Reverse Order） (reverse)	false	如果你希望页面的显示方式按照逆序显示的话，你需要选择这个。这个参数需要与参数 页面排序方式（Sort Pages By）结合使用。
在页面树中显示搜索对话框（Include Search Box above Page Tree） (searchBox)	false	如果你希望在页面树中显示查找对话框，你需要选择这个。查找对话框允许你在页面树中对输入的字符进行查找。
显示 折叠/展开 链接（Show Expand/Collapse Links） (expandCollapseAll)	false	如果你希望在页面树中显示 展开所有（ 'expand all'）和 折叠所有 （'collapse all'）链接的话，你需要选择这个。用户可以使用上面两个链接对页面树进行展开或者折叠。 在存储格式和 Wiki 标记格式中可以使用的值： true – 显示 展开所有（ 'expand all'）和 折叠所有 （'collapse all'）选项。 false – 不显示 显示 展开所有（ 'expand all'）和 折叠所有 （'collapse all'）选项。
开始深度（Start Depth） (startDepth)	1	输入任何大于 0 的值来确定在第一次页面载入的时候希望子页面显示的深度。

来源：http://cwiki.ossez.com/pages/viewpage.action?pageId=2393329