Atlassian产品培训知识库
空间快捷链接
页面树结构
Skip to end of metadata
Go to start of metadata

图片相册（Gallery）宏在页面中按照表格的方式显示图片的缩略图，图片的是基于页面中附件的图片进行显示的。

换句话说，你需要将显示的图片做为附件上传到页面中才可以。

用户可以通过单击缩略图来放大图片到全屏大小，然后可以通过幻灯片的方式浏览图片。

概述：

  • 图片的来源是 Confluence 页面中存储的附件图片。你可以为这个宏参数指定不同的页面。有关向页面中上传附件的方法，请参考 向页面中上传文件中描述的相关内容。
  • 有关图片的说明的数据是来自附件中有关图片的备注。有关向页面中上传附件的方法，请参考 向页面中上传文件中描述的相关内容。
  • 在默认设置的情况下，图片相册宏将会包含页面中所有的图片附件，你可以使用参数来将一些不希望包含的图片附件排除在外。
  • 你可以对显示的图片按照特定的排序方式进行排序。
  • 你可以为图片相册宏指定标题，同时也可以为图片相册宏确定按照几列进行显示。

使用实例：图片相册宏的实际使用实例


使用图片相册宏

希望在页面中使用图片相册宏：


  1. 打开你希望编辑 Confluence 页面，然后单击 编辑（Edit）按钮。页面的编辑模式将会被打开。
  2. 下一步，在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
  3. 在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击 插入（insert）来将需要的宏插入到页面中。


参数

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

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 – 排序方式为增序。

图片文件格式


你可以将图片文件附加到任何页面中。Confluence 的图片相册宏支持下面的图片格式在页面中进行显示：

  • gif
  • jpeg
  • png
  • bmp （与浏览器的支持程度有关）




代码示例

下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。

宏名称： gallery

宏内容： None.

存储格式示例

<ac:structured-macro ac:name="gallery">
  <ac:parameter ac:name="title">My holiday pictures</ac:parameter>
  <ac:parameter ac:name="reverse">true</ac:parameter>
  <ac:parameter ac:name="sort">size</ac:parameter>
  <ac:parameter ac:name="page">My page1, ds:Welcome to Confluence</ac:parameter>
  <ac:parameter ac:name="excludeLabel">badlabel1, badlabel2</ac:parameter>
  <ac:parameter ac:name="columns">3</ac:parameter>
  <ac:parameter ac:name="exclude">badpicture.png</ac:parameter>
</ac:structured-macro>

Wiki 标记格式示例

{gallery:title=My holiday pictures|reverse=true|sort=size|page=My page1, ds:Welcome to Confluence|excludeLabel=badlabel1, badlabel2|columns=3|exclude=badpicture.png}






  • 无标签