宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(example)。
有关图片相册宏的完整参数列表，请参考下面的表格。如果附件文件名或者页面名字包含有逗号，你可以参考下面有关的参数设置，对逗号用单引号或者双引号进行包裹，例如下面的格式："this,that.jpg", theother.png
|
参数
|
默认值
|
说明
|
图片相册标题（Gallery ）Title
(title) |
Nothing |
为你的图片相册宏指定标题。 |
列的数量（Number of Columns）
(columns) |
4 |
指定你图片相册宏的表格显示几列。 |
去除图片（Images to Exclude）
(exclude) |
No exclusions. 包含页面中的所有图片。 |
图片相册宏将会忽略任何指定的图片。你可以指定一个或者多个图片，图片名字采用逗号分隔符进行分隔。
注意：这个参数中指定的文件名和文件类型是大小写敏感的。例如， 'my picture.PNG' 和 'my picture.png' 被认为是不同的文件。 |
仅仅包含指定的图片（Include these Images Only）
(include) |
Include all the pictures on the page. |
图片相册将会使用你指定的一个或者多个文件进行显示。图片名字采用逗号分隔符进行分隔。
注意：这个参数中指定的文件名和文件类型是大小写敏感的。例如， 'my picture.PNG' 和 'my picture.png' 被认为是不同的文件。 |
去除包含有指定标签的图片（Exclude Images with these Labels）
(excludeLabel) |
No exclusions。将会包含页面中的所有图片。 |
图片相册宏将会忽略任何指定的图片。你可以指定一个或者多个图片，图片名字采用逗号分隔符进行分隔。 有关向图片添加标签的方法请参考添加标签页面中的说明。 |
仅仅包含有指定标签的图片（Include Images with these Labels Only）
(includeLabel) |
None. 图片不会按照标签进行过滤 |
对图片按照指定的标签进行过滤。你可以使用一个或者多个标签，在多个标签情况下，你需要使用逗号分隔符进行分隔。
Confluence 将会显示包含有所有标签的图片，我们可以在这里认为标签的逻辑运算使用的是 AND 不是 OR。
有关向图片添加标签的方法请参考添加标签页面中的说明。
|
使用指定页面的图片（Use Images in these Pages）
(page) |
如果你不指定页面名称，那么图片相册宏将会使用宏所在的页面中的附件。换句话说，默认使用的是当前页。 |
在这里指定页面的名称，图片相册宏将会根据你指定的页面名称到这个页面中去获取图片附件。
你可以指定一个或者多个页面的名称，多个页面的名称采用逗号分隔符进行分隔。
如果你希望指定其他空间中的页面，你可以采用下面的句法： SPACEKEY:Page Title
|
按照何种方式对图片排序（Sort Images By）
(sort) |
None. 因为排序方式不确定的，所以这的排序是随机排序。 |
指定图片的排序方式特性。排序默认采用的是增序的方式，除非你指定了 逆向排序（Reverse Sort） 参数。有关逆向排序参数请参考下面的说明。可选的参数如下：
- name – 文件名
- comment – 附件文件中的备注或者说明
- date – 最后修改的时间。
- size – 附件文件的大小。
|
逆向排序（Reverse Sort）
(reverse) |
Off. 排序方式采用的是增序。 |
需要与参数 按照何种方式对图片排序（Sort Images By）结合使用。使用这个参数将会对排序方式进行逆向排序，排序方式将会从增序修改为降序。
在 Wiki 格式和存储格式中可用的值为：
- true – 排序方式为降序。
- false – 排序方式为增序。
|
来源：http://cwiki.ossez.com/pages/viewpage.action?pageId=2393265