中文标题【附件(Attachments )宏】
附件宏显示添加到一个页面中的所有文件列表。
同时附件宏允许用户(用户需要具有正确的权限)来进行下面的操作:
- 直接从列表中上传一个文件到页面
- 编辑附件属性和标签
- 删除一个附件文件(这个将会删除文件的所有版本)
- 预览图片附件
- 下载附加到页面中的所有文件,
注意:如果你的附件非常大的话,你可用使用宏参数来关闭预览功能。
屏幕截图:附件宏显示一个附件的细节
使用附件宏
希望添加附件宏到一个页面中:
可用使用自动完成加快这个过程:输入 { 然后开始输入你希望插入的宏的名字,你将会看到建议的宏的列表。在这个列表中,我们插入 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 | 如果设置值为 |
Sort By(sortBy ) | date | 为了对附件进行排序,请注意,用户对页面进行查看的时候,用户可以通过单击每一个列表的头部来对列表进行排序。可以进行排序的变量有:
|
Sort Order(sortOrder ) | ascending | 使用组合的排序( Sort By )参数进行排序,来对附件按照升序或者降序进行排序。 |
Allow Upload(upload ) | true | 如果被选中,附件的列表将会包含运行用户进行浏览和附加一个新文件的选项。 |
Page Title(page ) | (None) | 被用来从其他页面中显示附件。如果你不输入页面的标题的话,宏将会显示附加到当前页面的所有文件。 |
Show Previews ( preview ) | true | 被用来显示一个附件文件的预览。如果是 true 的话,当列表项目被展开的时候预览将会显示。 |
Wiki 标记(markup) 示例
宏名称: attachments
宏内容: None
|
编辑一个附件
在 Confluence 中有下面一些方法可以对附件进行编辑。
希望从附件宏列表中进行编辑:
- 单击文件名边上的箭头来查看版本的历史。
- 单击编辑(Edit)。
- 选择你希望编辑文件的应用程序,
- 对文件进行编辑,然后在桌面应用程序中保存你所做的修改。
- 在 Confluence,单击 上传(Upload)来确定你希望保存你编辑过的文件的新版本。
请查看 Edit Files 页面中的内容来获得更多的信息。