本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=97911315

附件宏以文件列表形式显示当前页面或站点中其它页面的附件。

这个宏可以帮助您快速访问：

  • 项目文件
  • 可下载的表格和模板
  • 图片和图表

Because you can display files attached to any page, you can use this macro to avoid duplication if you need to provide quick access to the same file on multiple pages.

因为这个宏可以显示任何页面的附件，所以如果您需要在多个页面上提供对同一文件的快速访问，您可以使用此宏来避免重复上传。

相关页面：

截图：附件宏，显示附件的详细信息。

添加到页面后，具有相关权限的用户可以：

Once added to a page, people with appropriate space permissions can:

  • 查看附件列表
  • 直接从列表上传文件到页面
  • 编辑附件属性和标签
  • 删除附件（这将删除附件的所有版本）
  • 预览图片文件
  • 将页面的所有附件下载为 zip 文件

关于在Confluence中处理文件的文档，请参考Files。

在页面添加宏

在页面中添加附件宏：

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从Confluence content类别中选择Attachments。
  3. 设置参数。都是可选的。
  4. 点击Insert。

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

截图：配置附件宏。

修改宏参数

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

要更改宏参数：

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

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

参数

默认值

描述

Filename Patterns
(patterns)

all

一个使用逗号分隔符的正则表达式，被用来通过文件名对附件进行过滤。请注意参数值必须是正则表达式。例如：

  • 为了匹配文件的后缀名 'jpg'，请使用 .*jpg （不是 *.jpg）
  • 为了匹配文件名的后缀是  'jpg' 或 'png'，请使用 .*jpg,.*png

Attachment Labels
(labels)		(none)

标签列表，用于过滤要显示的附件。如果您希望输入多个标签，请用逗号分隔标签。Confluence将只显示指定了所有标签的附件。（匹配规则是 AND，而不是 OR。）关于附件标签的文档，请参考Add, Remove and Search for Labels。

Include Old Attachment Versions
(old)

false

值为true时将包含之前的所有版本。

Sort By
(sortBy) 

date

The sort order for attachments. Note that people viewing the page can change the sort order by clicking the column headings. Valid values are:

附件的排序规则。请注意，查看页面的用户可以通过单击列标题来更改排序顺序。有效值包括：

  • date – 按更新日期进行排序（最新的排在前面）
  • size – 从大到小进行排序
  • name – 按字符顺序进行排序
  • created date - 按创建日期进行排序（最新的排在前面）
Sort Order
(sortOrder) 		ascending与Sort By参数结合使用，以升序或降序对附件进行排序。

Allow Upload
(upload) 

true

如果勾选，附件列表将包括允许用户添加新文件的选项。

Page Title
(page) 		(none)用于显示来自其它页面的附件。如果不输入页面标题，将显示当前页面的附件。
Show Previews
(preview) 		true

用于预览附件。如果为true，则在展开列表项时可以看到预览效果。

如果您有非常大的附件，最好禁用预览功能。

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

通过附件宏编辑附件

在Confluence中有多种方法可以对附件进行编辑。

要从附件宏编辑附件：

  1. 单击文件名边上的箭头来查看历史版本。
  2. 单击编辑（Edit）。
  3. 您安装的Atlassian Companion程序将启动并打开文件。
  4. 修改并保存文件。然后，单击在Companion中的Upload，将文件发送回Confluence。

请参考editing files in Confluence文档获取更多信息。

其它添加方式

用键盘输入添加宏

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

通过wiki标记添加宏

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

Macro name: attachments

Macro body: None.

{attachments:old=false|patterns=.*png,.*jpg|sortby=name|page=My page about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false|preview=false}
CODE