使用文档
在 Confluence 页面中显示变化
将页面变化宏插入 Confluence 页面,读者就能在阅读正文时查看更新。页面作者选择比较范围;读者可以在页面内展开结果,也可以打开更大的比较弹窗。
插入宏
- 编辑需要展示变化的 Confluence 页面。
- 打开编辑器工具栏的插入元素,搜索页面变化。也可以在完整元素浏览器中查找;英文界面搜索 Page changes。
- 选择宏,打开页面变化设置。
- 选择比较模式。希望展示最近一次更新时,可以保留默认的最近一次修改。
- 点击保存,再发布或更新 Confluence 页面。

保存宏设置不等于发布标准页面或博客文章。在这些内容的编辑器中,宏先显示说明文字,发布后才显示结果。实时文档(Live doc)使用已保存内容,无需这一步发布操作。
宏比较整个页面的正文,不限于宏所在位置之后的内容。本应用的“页面变化”宏及其设置会被排除,因此插入宏或调整设置本身不会计为正文变化。
选择比较范围
| 设置选项 | 读者看到什么 | 适合的用途 |
|---|---|---|
| 最近一次修改 | 最新版本与上一个可用历史版本的变化。 | 快速检查上一次更新。 |
| 自固定基准版本以来 | 本页某个固定版本到最新版本的变化。 | 检查发布评审或约定里程碑之后的修改。 |
| 自每位读者上次查看以来 | 当前读者上次记录的版本到本次记录版本的变化。 | 补看自己上次打开页面后的更新。 |
| 与其他页面对比 | 参考页面与当前宏所在页面的差异。 | 检查项目文档与标准文档的区别。设置参考页面。 |
前两种模式支持标准页面、博客文章和实时文档;上次查看模式仅支持已发布的标准页面。所有模式都使用可读取的已发布或已保存内容,不比较未发布草稿,也不实时追踪每次输入。
保留固定基准
- 选择自固定基准版本以来。
- 选择读者需要对照的本页版本。
- 按需填写基准标签,例如“发布评审”。
- 点击保存,再更新页面。

例如基准为 v1,页面以后更新到 v2、v3,起点仍是 v1。此设置中的“最新版本”在保存时也会固定为数字版本,不会自动向前推进。标签只是可选说明,不具有审批或签名效力。
新页面需要先有已发布版本才能选择基准。将宏复制到另一页面后,需要编辑宏,从新页面自己的历史中重新选择基准。
展示每位读者自己的变化
选择自每位读者上次查看以来,每个人就会获得自己的比较范围。例如,某位读者上次记录在 v1,本次打开 v3 时会比较 v1 → v3;上次已经看过 v2 的读者则会看到 v2 → v3。
第一次被记录的访问会建立起点,并显示说明。重新打开或刷新页面都会记录一次新访问:随即刷新 v3,可能就会看到“自你上次查看以来没有新版本”。展开、收起、打开或关闭比较弹窗不会推进记录。
希望保留某次结果供稍后查看时,可先打开完整比较并复制分享链接,再刷新页面。需要让团队使用共同起点时,请选择固定基准模式。访问记录不代表读者已经读完或批准了修改。
在页面内阅读变化
每个宏都会显示比较模式、可取得的作者或访问信息,以及变化数量。同一页面可以放置多个宏,并分别设置不同范围。

- 点击展开在当前页面阅读;点击收起返回卡片。
- 点击查看变化打开完整比较弹窗。跨页模式的按钮名称为查看差异。
- 切换合并视图或并排视图,使用上一处变化和下一处变化逐项检查。
- 在并排视图中使用同步滚动,让两侧阅读位置联动。
卡片和内嵌结果不显示系统版本号及高级操作。需要核对实际版本、临时切换版本、分享或导出 PDF 时,打开完整比较。具体控件见阅读对比结果。
作者可以勾选默认在页面上展开完整对比,读者仍可手动收起。默认展开会在页面打开时加载完整结果;长页面或放置多个宏的页面,加载时间可能增加。
临时检查其他版本
在完整弹窗中,点击页面标题旁的版本菜单,选择要查看的版本。此操作只影响当前弹窗。范围偏离宏的设置后,点击恢复宏比较范围,即可回到原始页面组合、方向和版本。

关闭后重新从卡片打开,也会恢复卡片确定的范围。要永久修改宏,请编辑 Confluence 页面,选中宏并点击浮动工具栏的编辑,保存设置后再更新页面。
理解空结果
| 提示 | 含义 | 下一步 |
|---|---|---|
| 没有正文变化 | 已比较两个本页版本,未发现正文差异。 | 仍可打开结果查看。 |
| 未发现差异 | 已比较参考页和本页,未发现差异。 | 仍可打开结果查看。 |
| 第一个版本提示 | 本页还没有更早的历史版本。 | 后续发布更新后再使用最近一次修改模式。 |
| 基准之后还没有新版本 | 基准就是当前最新版本。 | 等待后续更新,或选择更早的基准。 |
| 自你上次查看以来没有新版本 | 两次访问记录的是同一版本。 | 宏此时不提供比较入口。 |
| 第一次被记录的访问提示 | 当前读者没有更早的访问记录。 | 页面更新后再次打开。 |
数量表示高亮变化范围,不是编辑次数或变化字数。一处文字替换可能同时包含删除和新增。图片重新上传或预览不可用等情况可能使卡片数量与完整结果不同,请以完整结果进行审阅。
访问权限和保存副本
读者使用自己的 Confluence 权限读取内容。页面或版本不存在、不可访问时,会显示不可用,不会当作空白文档或成功的零差异结果。基准不可用时,由作者重新选择;宏不会自动替换基准。
实时文档的连续保存可能合并到一个历史版本,因此每次保存不一定形成新的比较范围。在 Confluence 历史版本页面中看到的宏,也不是当时结果的存档。
需要保存差异时,在完整弹窗中选择导出 → PDF 导出。Confluence 自身的页面 PDF 或 Word 导出会使用静态宏说明,不包含交互式结果或某位读者的个人访问差异。需要保留差异时,请使用完整对比中的 PDF 导出。