Confluence 摘要(Excerpt)宏

本文介绍如何使用摘要宏来标记和存储可重用的内容,并解释了摘要宏的基本规则及其参数设置,包括如何控制内容显示。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

摘要宏在页面中被标记和存储可以重用的内容。当你定义一个摘要宏以后,这个摘要宏可以在其他宏中被引用,例如: 包含摘要(Excerpt Include)宏 和 博客页面(Blog Posts)宏,然后能够显示被标记的内容。

你只能在一个页面中定义一个摘要宏。换句话说,在一个页面中你只能插入摘要宏一次。

使用摘要宏

向宏中加入可以重用的内容:

将你需要插入的内容写入到摘要宏中的占位符中。

选择宏的占位符来查看边框的可选项。你可以选择在新的一行中显示还是在本行中显示。默认的情况下,内容会在新的一行中显示。如果你选择了在行内显示的选项,那么摘要宏的内容将会插入到同一个段落中。注意:,这个选项仅仅是在页面包含有摘要宏的时候有效,这个对引用这个宏的页面是无效的。

屏幕截图:摘要宏占位符和可选项



参数

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

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

参数

默认值

说明

隐藏扩展宏的内容(Hide Excerpted Content)
(hidden) 

false
控制在摘要宏占位符中的内容是否在页面上显示。
注意:这个值对页面包含有摘要宏的时候有效。当页面内容被重用的时候是无效的。



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

<think>好的,用户想在Confluence中统计status的使用次数或相关数据。首先,我需要回忆一下Confluence的内置功能是否支持这种统计。根据之前的引用内容,比如引用[3]提到页面属性报表,但那是用来展示页面属性的,可能不直接支持使用统计。引用[5]提到JIRA报表蓝图,但这可能只适用于Jira问题。接下来,用户可能需要通过其他方法来实现。比如,使用Confluence的REST API来搜索所有页面中包含status的内容。引用[3]里提到浏览器插入的方法,但没提统计。可能需要使用CQL(Confluence QueryLanguage)来查询,比如搜索带有“ac:name=\"status\”的页面内容。不过用户可能需要技术能力来执行这样的查询,或者使用插件。比如,有些第三方插件如ScriptRunner forConfluence可能支持更复杂的统计。 另外,引用[1]中提到状态通常结合表格使用,放在单元格中,所以可能需要检查页面中的表格结构。但手动检查显然不现实。所以自动化方法更可行。比如编写脚本调用API获取所有页面,然后解析内容统计status的出现次数。或者使用数据库查询,如果有直接访问权限的话,但一般用户可能没有。还有一种可能是使用Confluence的导出功能,将空间数据导出为XML或HTML,然后用文本处理工具查找特定模式,比如<ac:structured-macro ac:name="status">,然后统计数量。这需要用户有导出权限和技术能力处理数据。最后,考虑是否有现成的插件或市场应用可以实现这个功能。比如看看AtlassianMarketplace有没有使用统计的工具。如果有的话,推荐用户安装。如果没有,可能需要定制开发或者使用脚本。 总结下来,步骤应该是:1.使用REST API搜索;2.数据库查询(如果有权限);3.导出后处理;4.第三方插件。同时提醒用户注意权限和技术要求,以及可能的数据量大时的性能问题。</think>在Confluence中统计`status`的使用情况,目前没有直接的内置功能,但可通过以下方法实现: --- ### **方法一:使用Confluence REST API搜索** 1. **通过标识符查询** `status`的HTML元素标识为`ac:name="status"`,可通过REST API的`/content/search`端点结合CQL(Confluence Query Language)筛选包含该的页面: ```http GET /wiki/rest/api/content/search?cql=text~"{status}"&expand=body.storage ``` 此方法会返回包含`status`的页面列表,但需自行解析响应结果并统计次数[^3][^5]。 2. **脚本自动化统计** 使用Python调用API并解析JSON响应,统计`<ac:structured-macro ac:name="status">`的出现次数: ```python import requests url = "https://your-confluence-site/rest/api/content/search" params = { "cql": 'text~"{status}"', "expand": "body.storage" } headers = {"Authorization": "Bearer YOUR_TOKEN"} response = requests.get(url, headers=headers, params=params).json() status_count = 0 for page in response["results"]: content = page["body"]["storage"]["value"] status_count += content.count('ac:name="status"') print(f"Status使用次数:{status_count}") ``` --- ### **方法二:数据库直接查询(需管理员权限)** 若有权访问Confluence数据库,可直接查询`BODYCONTENT`表中包含代码的条目: ```sql SELECT COUNT(*) FROM BODYCONTENT WHERE BODY LIKE '%<ac:structured-macro ac:name="status">%'; ``` --- ### **方法三:导出数据后本地分析** 1. 导出特定空间或全部空间的页面为XML/HTML格式。 2. 使用文本处理工具(如`grep`)统计: ```bash grep -ro '<ac:structured-macro ac:name="status"' ./exported_pages | wc -l ``` --- ### **方法四:第三方插件扩展** - **Comala Scripts**:支持自定义脚本统计使用情况。 - **Power Scripts for Confluence**:提供高级查询和批量操作功能。 --- ### **注意事项** - **权限限制**:API和数据库方法需管理员权限。 - **性能影响**:全空间统计可能耗时较长,建议分空间处理。 - **精确性**:文本匹配可能误判注释或示例代码中的,需人工复核。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值