- 由 郭春晓创建, 最后修改于一月 05, 2018
内容标签显示宏将会按照指定的特定标签显示被标记的页面,博客页面和附件。
使用内容标签宏
如果希望将页面标签显示宏添加到页面:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|---|---|
标签名称 | None | 按照标签过滤。这个宏仅仅显示指定了的标签内容。请参考下面 操作符(Operator )参数的说明。
|
作者 | None | 按照作者进行过滤。如果你指定了作者,那么这个宏将会仅仅显示有你指定作者的页面。 jsmith,jbrown 如果希望包含一个作者,然后剔除其他作者,请使用下面的格式: |
仅包含这个内容类型(Include this Content Type Only) | all | 按照内容类型进行过滤。如果你指定了内容类型,那么这个宏将会仅仅显示你指定的内容类型。 -blogpost ,你将会得到除了博客页面的页面和所有其他内容。可用的值:
|
为美国页面显示标签(Show Labels for Each Page) | true | 在结果中显示或者隐藏标签。 |
为页面显示空间名(Show Space Name for Each Page) | true | 在结果中显示或者隐藏空间。 |
标题列表(List Title) | None | 在结果中显示或者隐藏标题。 |
页面最大数量(Maximum Number of Pages) | 15 | 限制结果中显示的数量。注意,在结果处理的时候先对结果进行排序,然后在对显示结果的数量进行控制。parameter is applied. |
显示摘要(Display Excerpts) | false | 为显示的页面列表显示摘要。注意你必须为你的页面定义摘要,你需要通过 包含摘要宏 为页面定义只要。 只有摘要的第一行被显示。 |
限制到空间(Restrict to these Spaces) | @all | 按照空间进行过滤。宏将会显示指定中间中的内容,换句话说将会在指定的空间中进行内容查找。
值:
当你指定一个个人空间的时候,请记住在个人空间名字前加一个波浪符(~)例如 |
操作符(Operator) | OR | 当空间内容标签进行定义的时候,这个参数将会被使用:
|
排序方式(Sort By) | modified | 指定返回的结果如何进行排序。
注意:如果这个参数没有被指定的话,那么排序默认采用的是记忆最后的修改时间降序排序。 如果希望不使用增序或者降序的排序,使用 逆向排序(Reverse Sort) 参数。 |
逆向排序(Reverse Sort) | false | 选择 逆向排序(Reverse Sort)来修改排序方式从增序到降序。使用这个参数需要结合 排序方式(Sort By)参数一同使用。如果你没有指定 排序方式(Sort By)这个参数的话,逆向排序的这个参数就会被忽略。 |
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称: contentbylabel
宏内容: None
存储格式示例
|
Wiki 标记示例
|
- 无标签