将图库宏添加到页面以显示添加到该页面或其它Confluence页面的图像集合。

这个宏适用于:

  • 集合一组添加到几个不同页面的图像
  • 以特定顺序显示一组图像,例如按日期

与简单地将一组图像插入页面相比,图库宏的一个好处是它会在页面添加或删除文件时自动更新。

截图:页面上的图库宏显示了来自该页面的图像,带有文字。

图片下方的文字来自附件的评论。 有关向附件添加评论的文档,请参阅Upload Files

关于在Confluence中处理文件的文档,请参阅Files

在页面中添加宏

在页面中添加Gallery宏:

  1. 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)
  2. MediaVisuals & Imagery类别中选择Gallery
  3. 使用下方的宏参数指定要显示的文件。
  4. 点击Insert。 

然后,您可以发布您的页面以查看宏的效果。

截图:为图库宏输入参数

修改宏参数

宏参数用于设置宏的行为。

要更改宏参数:

  1. 在编辑器中,点击宏占位符并选择“编辑(Edit)”。
  2. 根据需要设置参数,然后选择“插入(Insert)”。

这是此宏中可用的参数列表。

参数

默认值

描述

Gallery Title
(title

Nothing

指定图库的标题。

Number of Columns
(columns

4

指定表的列数。

Images to Exclude
(exclude

No exclusions. Include all the pictures on the page.

指定图库将忽略的图片。您可以指定多张图片,用逗号分隔。

注意:此参数的文件名和文件类型区分大小写。 例如,“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 all the pictures on the page.

图库将忽略任何具有指定标签的图片。您可以指定多个标签,以逗号分隔。 有关附件标签的信息,请参阅Add, Remove and Search for Labels

Include Images with these Labels Only
(includeLabel
None. The images are not filtered by label.

根据标签列表过滤要显示的图像。如果您希望输入多个标签,请用逗号分隔标签。 Confluence将只显示指定了全部标签的图像。 (用AND匹配,而不是OR。)有关附件标签的信息,请参阅Add, Remove and Search for Labels

Use Images in these Pages
(page

If no page is specified, the gallery macro displays the images attached to the page on which the macro is used.

Specify the title of the page which contains the images you want displayed. You can specify more than one page name, separated by commas. To specify a page in a different space, use the following syntax:

指定要显示的图像所在页面的标题。您可以指定多个页面名称,以逗号分隔。要指定不同空间中的页面,请使用以下语法:SPACEKEY:Page Title

Sort Images By
(sort

None. The sort order is unspecified and therefore unpredictable.

指定用于图像排序的属性。排序顺序是升序,除非您选择反向排序参数(见下文)。选项是:

  • name – 文件名。
  • comment – 附件的评论。
  • date – 上次修改的日期/时间。
  • size – 附件的大小。

Reverse Sort
(reverse

Off. Sort order is ascending

与上面的Sort Images By参数结合使用。使用反向排序来反转排序顺序,从升序变为降序。

可用值:

  • true – 排序顺序为降序。
  • false – 排序顺序为升序。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同,则会在参数名下方用括号列出,例如(example)。

如果附件或页面的名称包含逗号,您可以在相关参数中用单引号或双引号将它括起来,例如"this,that.jpg", theother.png

图像文件格式

您可以将任何格式的图像文件添加到页面。Confluence在图库宏中以及在页面上显示图像时支持以下图像格式:

  • gif
  • jpeg
  • png
  • bmp (取决于浏览器支持)

其它添加方式

用键盘输入添加宏

输入左大括号{,然后输入宏名称的几个起始字符,就可以看到一个相关的宏列表。

通过wiki标记添加宏

当您想在编辑器之外添加宏时,这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。

Macro name: gallery

Macro body: None.

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