Page tree
Skip to end of metadata
Go to start of metadata

中文标题【附件(Attachments )宏】

附件宏显示添加到一个页面中的所有文件列表。

同时附件宏允许用户(用户需要具有正确的权限)来进行下面的操作:

  • 直接从列表中上传一个文件到页面
  • 编辑附件属性和标签
  • 删除一个附件文件(这个将会删除文件的所有版本)
  • 预览图片附件
  • 下载附加到页面中的所有文件, 

注意:如果你的附件非常大的话,你可用使用宏参数来关闭预览功能。

屏幕截图:附件宏显示一个附件的细节


使用附件宏

希望添加附件宏到一个页面中:

  1. 从编辑工具栏中,选择 插入(Insert)   > 其他宏(Other Macros
  2. 找到并且选择需要的宏。

可用使用自动完成加快这个过程:输入 然后开始输入你希望插入的宏的名字,你将会看到建议的宏的列表。在这个列表中,我们插入 cheese 宏(cheese macro)。

如果需要对已经存在的宏进行编辑:单击宏的占位符,然后选择 编辑(Edit。这将打开宏的细节,你可以对宏的参数进行编辑。

参数

参数是让你可以用来控制宏的格式和输出的选项。在 Confluence 存储格式或者 Wiki 标记(wikimarkup)中使用的参数名与在宏浏览器中使用的标签名是不同的,在下面我们将会用括号列出  (example)

参数名称默认值描述
Filename Patterns
(patterns)
all

Attachment Labels
(labels)
(None)

标签(labels)的列表,用来过滤附件的显示。如果你希望输入多个标签的话,请使用逗号分隔符来分隔需要使用的标签。Confluence 将会仅显示附件,这个附件具有所有(all)标记的标签。匹配条件是是 AND 而不是 OR。有关对附件进行标签的相关信息,请参考 Add, Remove and Search for Labels 页面中的内容。

Include Old Attachment Versions
(old)
false

如果设置值为 true 的话,将会包含前期的所有版本在列表中。

Sort By
(sortBy) 
date

为了对附件进行排序,请注意,用户对页面进行查看的时候,用户可以通过单击每一个列表的头部来对列表进行排序。可以进行排序的变量有:

  • 日期(date) – 对日期进行排序(最新的排在前面)
  • 大小(size)– 按照从大到小的顺序进行排序
  • 名字(name)– 按照字符顺序进行排序
  • 创建日期(created date) - 按照创建日期的倒序进行排序(最新的排在前面)
Sort Order
(sortOrder) 

ascending

使用组合的排序( Sort By )参数进行排序,来对附件按照升序或者降序进行排序。

Allow Upload
(upload) 
true

如果被选中,附件的列表将会包含运行用户进行浏览和附加一个新文件的选项。

Page Title
(page) 
(None)被用来从其他页面中显示附件。如果你不输入页面的标题的话,宏将会显示附加到当前页面的所有文件。
Show Previews
(preview) 
true被用来显示一个附件文件的预览。如果是 true 的话,当列表项目被展开的时候预览将会显示。

Wiki 标记(markup) 示例


宏名称: attachments

宏内容: None

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


编辑一个附件

在 Confluence 中有下面一些方法可以对附件进行编辑。

希望从附件宏列表中进行编辑:

  1. 单击文件名边上的箭头来查看版本的历史。
  2. 单击编辑(Edit)
  3. 选择你希望编辑文件的应用程序,
  4. 对文件进行编辑,然后在桌面应用程序中保存你所做的修改。
  5. 在 Confluence,单击 上传(Upload)来确定你希望保存你编辑过的文件的新版本。

请查看 Edit Files 页面中的内容来获得更多的信息。


  • No labels