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

猜你喜欢

转载自osseztec.iteye.com/blog/2022677