内容报表宏,用于在页面中使用格式化的表格样式显示一系列的页面和博客页面。具体要显示那些页面,可以在宏参数中指定标签。
一个内容报表宏的实例
下面是一个内容报表宏的实例,在这个实例中,我们显示了被标记为 'Confluence' 的页面。
Title | Creator | Modified |
---|
No content found. |
使用内容报表宏
希望在页面中添加一个内容报表宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 是否必须 | 默认值 | 说明 |
---|
标签(Label)
(labels ) | No | None | 这个参数是必须的。通过这个参数指定一个或者多个标签,这些标签按照逗号分隔符进行分隔。这个宏将会显示被标记为这些标签的页面。 例如,如果你指定标签 'A' 和 'B',那么这个宏将会显示所有包含有 'A' 的页面和包含有 'B' 的页面和所有含有这 2 个标签的页面。 |
空间(Space)
(spaces ) | Yes | (All spaces) | 指定一个或者多个空间的 Key,空间的 Key 值使用逗号分隔符进行分隔。这时,宏将显示属于你指定空间的页面。 当你指定的是一个个人空间的时候,请记住你需要在空间的名字前加一个波浪号(~),如下面的格式: ~jbloggs 或者 ~jbloggs@example.com |
页面显示最大值(Maximum Number of Pages)
(maxResults ) | No | 20 | 定义宏默认的最大返回结果集,这个结果集将会作为列表显示。 如果返回的结果大于指定的返回结果集,那么将会有字符 'Find more results' 出现。用户可以通过单击这个链接进入到查找视图来查看更多页面,这时候将会把标记为指定标签的所有页面都显示出来了。 将有哪些页面会被被显示?当将结果显示给用户的时候 Confluence 将会按照页面最后的修改日期进行排序。最新的页面(新建的页面和更新过的页面)在最前面。 |
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称: content-report-table
宏内容: None.
存储格式示例
< ac:structured-macro ac:name = "content-report-table" >
< ac:parameter ac:name = "spaces" >
< ri:space ri:space-key = "DOC" />
</ ac:parameter >
< ac:parameter ac:name = "labels" >LDAP</ ac:parameter >
< ac:parameter ac:name = "analytics-key" >meeting-notes</ ac:parameter >
< ac:parameter ac:name = "maxResults" >5</ ac:parameter >
</ ac:structured-macro >
|
Wiki 标记示例
这个宏没有维基(Wiki)标记格式。你不可以在宏中使用维基标记格式。