Confluence 6.15 博客页面(Blog Posts)宏参数

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

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

参数

是否是必须

默认值

说明

显示的内容类型(Content Type to Display)

(content)

No    titles    

可用的值:

titles — 在博客页面中仅显示标题。
excerpts — 为美国博客显示短摘要。如果博客有包含摘要宏,那么博客页面宏将会显示博客摘要中的内容。如果博客没有摘要宏,那么博客页面将会显示博客的前几个句子。
entire - 为每一个博客显示完整的内容。

时间帧(Time Frame)
(time) No 无限制

指定 Confluence 在博客中查找的时间范围。

可用的值:

m — 分钟
h — 小时, 如果你指定为 '12h' 的话,那么将会显示最新 12 个小时添加的博客。
d — 天,如果你指定为 '7d' 的话,那么将会显示博客最新七天的博客。
w — 周

标签限制(Restrict to these Labels)
(label) No None

通过标签过来结果。宏将会仅仅显示包含有你指定标签的博客,换句话说就是按照标签过滤。

你可以通过逗号分隔符来指定一个或者多个标签。

如果你希望扩展标签的的匹配内容,你可以在标签名字前加一个横线(-)。例如:如果你指定一个标签的名字为 -badpage 那么你将会找到所有没有标记为 'badpage' 标签的页面。
如果你希望某一个页面必须包含有某一个标签值,你需要在标签值之前加一个加号(+)。例如:如果你指定一个标签 +superpage,+goodpage 你将会找到页面至少包含有 2 个标签,而且这些页面的标签中都包含有字符 'superpage' 和 'goodpage'。

作者限制(Restrict to theseAuthors )

(author)

No    None    对返回的结果通过作者过滤。博客页面宏将会仅仅将你指定的作者的博客显示出来。

空间限制(Restrict to these Spaces)

(spaces)

No    @self 例如,在宏中显示空间包含的页面。    

这个参数允许你通过空间过滤内容。如果这个参数被使用的话,将会显示你指定空间中的博客页面。

你可以通过逗号分隔符来指定一个或者多个空间。

如果希望不包含某一个空间,可以在空间名前面加一个横线(-)。例如:如果你不希望包含有一个空间 BADSPACE,那么你可以使用 -BADSPACE 定义。
如果希望你的结果必须从某一个空间里面来,那么你可以在空间名字的前面加一个加号(+)。例如:如果你指定一个空间名字为 +GOODSPACE ,你将会仅仅得到从 GOODSPACE 中来的内容。(请注意:这个功能不是必须的,因为每一个博客必须得属于一个空间。如果这个加号标记在一个空间名字前同时也在其他空间名字前面,那么这个标记将会被忽略)。

特殊值:

@self — 当前空间
@personal — 所有的个人空间
@global — 所有的站点空间
@favorite — 所有你标记为关注的空间
@favourite — 与上面 @favorite 是一样的
@all — Confluence 站点的所有空间
* — 与上面 @all 是一样的

当你指定一个个人空间的时候,请记住在个人空间名字前加一个波浪符(~)例如 ~jblogs 或者 ~jbloggs@example.com 。

博客页面的最大数量(Maximum Number of Blog Posts)

(max)

No    15    指定可以显示的的最大结果数量。请注意,在结果显示的时候,首先会对结果进行排序,然后在对结果输出的数量进行限制。

排序方式(Sort By)
(sort)  No creation

指定结果如何被排序。如果这个参数没有被指定的话,那么将会按照内容的创建时间采用降序的方式进行排序(最新的在前面)。

值:

title — 按照标题字母排序
creation — 按照内容被添加的时间进行排序
modified — 按照内容被最后修改的时间进行排序

反向排序(Reverse Sort)
(reverse)  No false

选择将排序从降序切换到升序(最老的在前面)。与参数 排序方式(Sort By)结合使用,如果你不指定排序方式的话,这个参数将会被忽略。

在存储格式和 Wiki 格式中,可以使用边栏 true 来激活排序方式。

Wiki markup example

宏名称: blog-posts

宏内容:None

{blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookies}

https://www.cwiki.us/display/CONF6ZH/Blog+Posts+Macro

目录
相关文章
|
4月前
markdown增加目录索引,实现点击目录跳转到对应的内容目录标题
markdown增加目录索引,实现点击目录跳转到对应的内容目录标题
78 0
Confluence 6.15 博客页面(Blog Posts)宏
博客页面宏允许你 Confluence 页面中显示博客页面。通过单击博客的标题将会把你链接到博客页面中。 使用博客页面宏 为了将博客页面宏添加到页面中:  从编辑工具栏中,选择 插入(Insert)   > 其他宏(Other Macros)找到并且选择需要的宏。
758 0
Confluence 6.15 附件宏参数
参数参数名称 默认值 描述 Filename Patterns(patterns) all Attachment Labels(labels) (None) 标签(labels)的列表,用来过滤附件的显示。
695 0
【亲测有效】无法定位链接器!请检查 tools\link.ini 中的配置是否正确的解决方案
在进行易语言静态编译的时候,出现了如下错误: 正在进行名称连接...正在统计需要编译的子程序正在编译...正在生成主程序入口代码程序代码编译成功等待用户输入欲编译到的文件名正在进行名称连接...开始静态链接...无法定位链接器!请检查 tools\link.ini 中的配置是否正确。
2306 0
Confluence 6 访问你的宏正文(body)
请查看 Writing User Macros 页面获得有关如何写用户宏的介绍。 这个页面介绍你可以在用户宏中可以使用的的代码信息。
1067 0
Confluence 6 用户宏示例 - NoPrint
这个示例演示了如何创建一个用户宏,这个宏包括了在查看页面中显示的内容,但是不被打印。 Macro name noprint Visibility Visible to all users in the Macro...
884 0
Confluence 6 用户宏示例 - Hello World
下面示例显示了如何创建一个用户宏,在这个用户宏中显示文本 'Hello World!' 和任何用户在宏内容中输入的内容。 Macro name helloworld Visibility Visible to a...
1158 0
|
搜索推荐
Confluence 6 访问导入页面列表的方法
在查看官方文档的时候,你有时候会发现在 Confluence 6 中,文档有个一个导入的页面。 例如一个导入页面 _DiagramConfluenceEnvironment, 但是通过官方文档,你始终没有办法找到这个页面。
989 0