页面树(Page Tree)宏在页面中显示页面的继承情况。这个从你指定的页面开始显示页面树,默认是从根页面(root)开始的。页面树可以作为内容列表或者主题列表。
当你查看页面树的时候,你可以随机单击页面树中的链接来链接到其他页面。当前页面在页面树结构中的位置是会被高亮显示的。
注意: 页面树在 Confluence 文件主题中常常被用于构造一个导航面板来显示你空间的内容列表。 请参考文档主题页面中有关说明。
使用页面树(Page Tree)宏
希望在页面中使用页面树(Page Tree)宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
在宏浏览器中单击 刷新(Refresh)按钮来让设置的宏参数生效。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 |
默认值 |
说明 |
---|---|---|
Root Page | 空间的主页 | 指定页面树的上级页面。页面树宏将会包含所有给定页面的子页面和子页面的子页面,一直到没有子页面位置。页面树将不会显示作为根页面给定的页面。
|
页面排序方式(Sort Pages By) | position | 在页面树中指定页面的排序方式。这个排序方式仅仅是在显示的时候使用的,这个排序不会对页面的实际存储顺序产生影响。你可以使用下面的一些值:
|
在页面树中包含摘要(Include Excerpts in Page Tree) | false | 如果你希望在页面树中为页面显示摘要,你需要选择这个。摘要在页面中需要有定义,请参考 摘要(Excerpt)宏 中的相关说明。 |
逆向排序(Reverse Order) | false | 如果你希望页面的显示方式按照逆序显示的话,你需要选择这个。这个参数需要与参数 页面排序方式(Sort Pages By)结合使用。 |
在页面树中显示搜索对话框(Include Search Box above Page Tree) | false | 如果你希望在页面树中显示查找对话框,你需要选择这个。查找对话框允许你在页面树中对输入的字符进行查找。 |
显示 折叠/展开 链接(Show Expand/Collapse Links) | false | 如果你希望在页面树中显示 展开所有( 'expand all')和 折叠所有 ('collapse all')链接的话,你需要选择这个。用户可以使用上面两个链接对页面树进行展开或者折叠。 在存储格式和 Wiki 标记格式中可以使用的值:
|
开始深度(Start Depth) | 1 | 输入任何大于 0 的值来确定在第一次页面载入的时候希望子页面显示的深度。 |
来源:http://cwiki.ossez.com/pages/viewpage.action?pageId=2393329