confluence - 各种 Confluence 文档格式有何不同？

Question

我正在使用 Confluence REST api ，并想提取一些文件。文档正文有多种格式:editor , storage , view , export_view , anonymous_export_view ,... 但我没有在任何地方找到关于它们是什么，或者每个人的目的的描述。 ( This answer 提到了几种格式，但没有说明它们是什么。)在我的检查中，所有格式都嵌入了 HTML 样式的标记，但具有不同的非标准属性。任何指针？

具体来说，我正在寻找用于转换为其他非融合格式的最佳格式。

示例查询:

https://confuence.example.com/rest/api/content?spaceKey=doc&expand=body.editor,body.storage,body.anonymous_export_view,body.view,body.export_view&start=0&limit=50

这将返回几种替代格式，我看到了许多看似随机的差异。那么故事是怎样的呢？

Answer 1

我在 Confluence 的 Java API 文档中找到了对这些字段的最佳描述，特别是 ContentRepresentation类(class)。

您可能会注意到上述文档中的一些描述被截断了。它们只是由 Javadoc 呈现的文档注释，所以那里出了点问题。碰巧的是，我为 Atlassian Premier Support 工作，所以我已经找到了完整的文档评论(代码搜索)，以供您阅读:

ANONYMOUS_EXPORT_VIEW

用于查看的 HTML 表示，但使用绝对 url，而不是标记中的相对 url，并且宏呈现为好像是由匿名用户查看的。在您可能不想泄露敏感数据或不想为导出支付权限检查费用的情况下导出时很有用。只要底层内容没有改变，它的输出就可以被缓存。

编辑

适合在富文本编辑器中使用的表示

EXPORT_VIEW

用于查看的 HTML 表示，但使用绝对 url，而不是标记中的相对 url。用于导出。

平原

原始数据库格式为纯文本，没有 XHTML 或 WIKI 标记。可以通过将换行符转换为
并将 URL 表示为 HTML 链接来转换为 VIEW 表示。

原始

原始“数据库”格式。

仓储

原始数据库格式，用于以我们的 XML 存储格式存储数据的内容

STYLED_VIEW

在元素中包含内联样式的渲染 View ，包裹在整个结构中。