从 BitBucket 在 Confluence 中显示 PlantUML答案

【问题标题】：Display PlantUML in Confluence from BitBucket从 BitBucket 在 Confluence 中显示 PlantUML
【发布时间】：2020-11-30 15:27:00
【问题描述】：

Confluence 支持使用例如 PlantUML for Confluence 宏来显示 PlantUML 图。基本上，只需复制粘贴 UML 图的源代码，它就会正确地呈现在页面中。

宏的使用和渲染：

问题：

我的目标是使图表与当前版本的代码保持同步。有没有办法将图表的源代码从存储库导入到 Confluence 中并显示图表（比如说来自 master 分支）？

由于 BitBucket 和 Confluence 是 Atlassian 的产品，并且可能可以很好地协同工作，因此我正在寻找这样的集成。如果有办法从显示的 GitHub/GitLab 获取源代码，我会更加感激答案。但是，使用 BitBucket - Confluence - PlantUML 的解决方案将绰绰有余。

【问题讨论】：

查看 Atlassian 的 API：您必须能够通过 API 调用编辑 wiki 中的页面。这意味着您可以编写一个脚本，当有人推送到您的 repo（来自 bitbucket/github/gitlab/...）时，可以通过 webhook 调用该脚本，并在 confluence 中更新 wiki 页面。
@LeGEC：我不确定我们这些开发人员是否有权在 Confluence 上执行此类操作。此外，我觉得这是一个矫枉过正。没有更简单的方法吗？但是，您可能想制定一个答案。
您可以尝试组合两个宏：您提到的 PlantUML 宏，以及 - 而不是自己编写 PlantUML 代码 - 在其中嵌套一个 bitbucket 宏。见mibexsoftware.atlassian.net/wiki/spaces/INCLUDE/pages/1703945/…这是未经测试的——我现在不能自己测试——但可能值得一试。 :-)
@observer：它看起来很有趣并且可能会起作用。我尝试让 Confluence 公司的所有者安装该插件并试一试。

标签： git bitbucket confluence plantuml confluence-macros

【解决方案1】：

我不是 Atlassian 用户，所以我对他们的工具没有多少实际经验。

可能有一种方法可以从 wiki 页面引用 bitbucket 存储库中的某些文档，扫描文档（或寻求支持）以确认。

其他可能性：

您的 Confluence 订阅背后的 wiki 可能本身就是一个 git 存储库。
例如，this Atlassian support page 解释了如何克隆托管在 bitbucket 云上的 wiki（我猜你的 wiki 可能可以通过这种方式访问）。

您必须检查如何设置访问权限以推送到该存储库，但更新存储库将是使用已知命令的问题：git fetch & update，编辑文件，git add & commit & push
您还可以查看 API 调用：如果您可以通过 API 更新 wiki 页面，您可以类似地设置一个作业，在轮询您能想到的任何来源后更新特定的 wiki 页面。

另外：您可以找到一种方法来在源上注册钩子以在需要时触发脚本的执行（例如通过 webhook），而不是让脚本轮询源代码。

【讨论】：