Confluence 6.15 附件宏参数和编辑附件

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

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

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

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

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

使用附件宏

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

  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 页面中的内容来获得更多的信息。