Confluence Gallery 图库宏
将图库宏添加到页面以显示添加到该页面或其它Confluence页面的图像集合。
这个宏适用于:
- 集合一组添加到几个不同页面的图像
- 以特定顺序显示一组图像,例如按日期
与简单地将一组图像插入页面相比,图库宏的一个好处是它会在页面添加或删除文件时自动更新。
截图:页面上的图库宏显示了来自该页面的图像,带有文字。
图片下方的文字来自附件的评论。 有关向附件添加评论的文档,请参阅Upload Files。
关于在Confluence中处理文件的文档,请参阅Files
在页面中添加宏
在页面中添加Gallery宏:
- 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)。
- 从Media或Visuals & Imagery类别中选择Gallery。
- 使用下方的宏参数指定要显示的文件。
- 点击Insert。
然后,您可以发布您的页面以查看宏的效果。
截图:为图库宏输入参数
修改宏参数
宏参数用于设置宏的行为。
要更改宏参数:
- 在编辑器中,点击宏占位符并选择“编辑(Edit)”。
- 根据需要设置参数,然后选择“插入(Insert)”。
这是此宏中可用的参数列表。
参数 | 默认值 | 描述 |
---|---|---|
Gallery Title | Nothing | 指定图库的标题。 |
Number of Columns | 4 | 指定表的列数。 |
Images to Exclude | No exclusions. Include all the pictures on the page. | 指定图库将忽略的图片。您可以指定多张图片,用逗号分隔。 注意:此参数的文件名和文件类型区分大小写。 例如,“my picture.PNG”将不会被识别为“my picture.png”。 |
Include these Images Only | 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 | 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: 指定要显示的图像所在页面的标题。您可以指定多个页面名称,以逗号分隔。要指定不同空间中的页面,请使用以下语法: |
Sort Images By | None. The sort order is unspecified and therefore unpredictable. | 指定用于图像排序的属性。排序顺序是升序,除非您选择反向排序参数(见下文)。选项是:
|
Reverse Sort | Off. Sort order is ascending | 与上面的Sort Images By参数结合使用。使用反向排序来反转排序顺序,从升序变为降序。 可用值:
|
如果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}