各种 Confluence 文档格式有何不同?

How do the various Confluence document formats differ?

我正在使用 Confluence REST api, and want to extract some documents. The document body is available in several formats: editor, storage, view, export_view, anonymous_export_view,... But I have not found a description anywhere of what they are, or what each one is intended for. (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

这 returns 几种替代格式,我看到了很多看似随机的差异。那么故事是怎样的呢?

我找到的每个字段的最佳描述在 Confluence 的 Java API 文档中,特别是 ContentRepresentation class.

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

  • ANONYMOUS_EXPORT_VIEW
    • HTML 用于查看的表示形式,但在标记中使用绝对 URL 而不是相对 URL,并且呈现宏,就好像它是由匿名用户查看的一样。在您可能不想泄露敏感数据或不想为导出支付权限检查费用的情况下,导出很有用。只要底层内容没有改变,就可以缓存它的输出。
  • 编辑
    • 表示适合在富文本编辑器中使用
  • EXPORT_VIEW
    • HTML 用于查看的表示,但在标记中使用绝对 URL,而不是相对 URL。对导出有用。
  • 平原
    • 原始数据库格式为无 XHTML 或 WIKI 标记的纯文本。可以通过将换行符转换为
      并将 URL 表示为 HTML 链接来转换为 VIEW 表示形式。
  • RAW
    • 原始 "database" 格式。
  • 存储空间
    • 原始数据库格式,用于以我们的XML存储格式
    • 存储数据的内容
  • STYLED_VIEW
    • 包含元素内联样式的呈现视图,包裹在整个结构中。