# Confluence 内容报表宏

**URL:** <https://www.isharkfly.com/t/confluence/6039>\
**Category:** 文档交付\
**Tags:** confluence\
**Created:** [February 12, 2014, 2:11pm UTC](https://www.isharkfly.com/t/confluence/6039 "2014-02-12T14:11:22Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![honeymoose](https://www.isharkfly.com/user_avatar/www.isharkfly.com/honeymoose/32/20796_2.png) [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Post date:** [February 12, 2014, 2:11pm UTC](https://www.isharkfly.com/t/confluence/6039/1 "2014-02-12T14:11:22Z")

</div>

内容报表宏，用于在页面中使用格式化的表格样式显示一系列的页面和博客页面。具体要显示那些页面，可以在宏参数中指定标签。

使用内容报表宏

希望在页面中添加一个内容报表宏：

打开你希望编辑 Confluence 页面，然后单击 编辑（Edit）按钮。页面的编辑模式将会被打开。

下一步，在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。

在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击 插入（insert）来将需要的宏插入到页面中。

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

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

[table]  
[tr][td][align=left]参数[/align]  
[/td][td]是否必须  
[/td][td][align=left]默认值[/align]  
[/td][td][align=left]说明[/align]  
[/td][/tr]  
[tr][td]标签（Label）  
(labels)   
[/td][td]No[/td][td]None  
[/td][td]这个参数是必须的。通过这个参数指定一个或者多个标签，这些标签按照逗号分隔符进行分隔。这个宏将会显示被标记为这些标签的页面。  
[align=left]例如，如果你指定标签 ‘A’ 和 ‘B’，那么这个宏将会显示所有包含有 ‘A’ 的页面和包含有 ‘B’ 的页面和所有含有这 2 个标签的页面。[/align][/td][/tr]  
[tr][td]空间（Space）  
(spaces)   
[/td][td]Yes[/td][td](All spaces)  
[/td][td]指定一个或者多个空间的 Key，空间的 Key 值使用逗号分隔符进行分隔。这时，宏将显示属于你指定空间的页面。  
[align=left]当你指定的是一个个人空间的时候，请记住你需要在空间的名字前加一个波浪号（~），如下面的格式： ~jbloggs 或者 [color=#3b73af][url=]~[jbloggs@example.com](mailto:jbloggs@example.com)[/url][/color][/align][/td][/tr]  
[tr][td]页面显示最大值（Maximum Number of Pages）  
(maxResults) [/td][td]No[/td][td]20[/td][td]定义宏默认的最大返回结果集，这个结果集将会作为列表显示。  
[align=left]如果返回的结果大于指定的返回结果集，那么将会有字符 ‘Find more results’ 出现。用户可以通过单击这个链接进入到查找视图来查看更多页面，这时候将会把标记为指定标签的所有页面都显示出来了。[/align][align=left]将有哪些页面会被被显示？当将结果显示给用户的时候 Confluence 将会按照页面最后的修改日期进行排序。最新的页面（新建的页面和更新过的页面）在最前面。[/align][/td][/tr]  
[/table]

来源：[http://cwiki.ossez.com/pages/viewpage.action?pageId=2393247](http://cwiki.ossez.com/pages/viewpage.action?pageId=2393247)
