Confluence 博客页面（Blog Posts）宏_confluence 将上传文件按最后修改时间排序

作者：笔触狂放9 | 2024-02-21 19:55:40

踩

confluence 将上传文件按最后修改时间排序

博客页面宏允许你 Confluence 页面中显示博客页面。通过单击博客的标题将会把你链接到博客页面中。

使用博客页面宏

为了将博客页面宏添加到页面中：
打开你希望编辑 Confluence 页面，然后单击编辑（Edit）按钮。页面的编辑模式将会被打开。
下一步，在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击插入（insert）来将需要的宏插入到页面中。

参数
宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(example)。

参数	是否是必须	默认值	说明
作者限制(author)	No	None	对返回的结果通过作者过滤。博客页面宏将会仅仅将你指定的作者的博客显示出来。你可以通过逗号分隔符将一个或者多个作者进行指定。例如： jsmith,jbrown 如果希望包含一个作者，然后剔除其他作者，请使用下面的格式： jsmith,!jbrown
博客页面的最大数量(max)	No	15	指定可以显示的的最大结果数量。请注意，在结果显示的时候，首先会对结果进行排序，然后在对结果输出的数量进行限制。
反向排序 (reverse)	No	false	选择将排序从降序切换到升序（最老的在前面）。与参数排序方式（sort）结合使用，如果你不指定排序方式的话，这个参数将会被忽略。在存储格式和 Wiki 格式中，可以使用边栏 true 来激活排序方式。
排序方式 (sort)	No	creation	指定结果如何被排序。如果这个参数没有被指定的话，那么将会按照内容的创建时间采用降序的方式进行排序（最新的在前面）。值： title — 按照标题字母排序 creation — 按照内容被添加的时间进行排序 modified — 按照内容被最后修改的时间进行排序
时间帧 (time)	No	无限制	指定 Confluence 在博客中查找的时间范围。可用的值： m — 分钟 h — 小时, 如果你指定为 '12h' 的话，那么将会显示最新 12 个小时添加的博客。 d — 天，如果你指定为 '7d' 的话，那么将会显示博客最新七天的博客。 w — 周
显示的内容类型 (content)	No	titles	可用的值： titles — 在博客页面中仅显示标题。 excerpts — 为美国博客显示短摘要。如果博客有包含摘要宏，那么博客页面宏将会显示博客摘要中的内容。如果博客没有摘要宏，那么博客页面将会显示博客的前几个句子。 entire - 为每一个博客显示完整的内容。
标签限制 (label)	No	None	通过标签过来结果。宏将会仅仅显示包含有你指定标签的博客，换句话说就是按照标签过滤。你可以通过逗号分隔符来指定一个或者多个标签。如果你希望扩展标签的的匹配内容，你可以在标签名字前加一个横线（-）。例如：如果你指定一个标签的名字为 -badpage 那么你将会找到所有没有标记为 'badpage' 标签的页面。如果你希望某一个页面必须包含有某一个标签值，你需要在标签值之前加一个加号（+）。例如：如果你指定一个标签 +superpage，+goodpage 你将会找到页面至少包含有 2 个标签，而且这些页面的标签中都包含有字符 'superpage' 和 'goodpage'。
空间限制(spaces)	No	@self 例如，在宏中显示空间包含的页面。	这个参数允许你通过空间过滤内容。如果这个参数被使用的话，将会显示你指定空间中的博客页面。你可以通过逗号分隔符来指定一个或者多个空间。如果希望不包含某一个空间，可以在空间名前面加一个横线（-）。例如：如果你不希望包含有一个空间 BADSPACE，那么你可以使用 -BADSPACE 定义。如果希望你的结果必须从某一个空间里面来，那么你可以在空间名字的前面加一个加号（+）。例如：如果你指定一个空间名字为 +GOODSPACE ，你将会仅仅得到从 GOODSPACE 中来的内容。（请注意：这个功能不是必须的，因为每一个博客必须得属于一个空间。如果这个加号标记在一个空间名字前同时也在其他空间名字前面，那么这个标记将会被忽略）。特殊值： @self — 当前空间 @personal — 所有的个人空间 @global — 所有的站点空间 @favorite — 所有你标记为关注的空间 @favourite — 与上面 @favorite 是一样的 @all — Confluence 站点的所有空间 * — 与上面 @all 是一样的当你指定一个个人空间的时候，请记住在个人空间名字前加一个波浪符（~）例如 ~jblogs 或者 ~ jbloggs@example.com 。

下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。

宏名称： blog-posts
宏内容： None.

存储格式示例

<ac:structured-macro ac:name="blog-posts">
<ac:parameter ac:name="content">titles</ac:parameter>
<ac:parameter ac:name="spaces">
<ri:space ri:space-key="ds"/>
</ac:parameter>
<ac:parameter ac:name="author">
<ri:user ri:userkey="12345678912345678912345678912345"/>
</ac:parameter>
<ac:parameter ac:name="time">4w</ac:parameter>
<ac:parameter ac:name="sort">creation</ac:parameter>
<ac:parameter ac:name="max">10</ac:parameter>
<ac:parameter ac:name="labels">chocolate,cookies</ac:parameter>
</ac:structured-macro>

复制代码

Wiki 标记示例

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

复制代码

来源： http://cwiki.ossez.com/pages/viewpage.action?pageId=2393219

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/笔触狂放9/article/detail/126166?site