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

Question

我正在使用Confluence REST api，并且想要提取一些文档。文档正文有多种格式：editor, storage, view, export_view, anonymous_export_view,... 但我没有在任何地方找到它们的描述，或者每个文件的用途。（这个答案提到了几种格式，但没有说明它们是什么。）在我的检查中，所有格式都嵌入了 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类。

您可能会注意到上述文档中的一些描述被截断。它们只是 Javadoc 呈现的文档注释，所以那里出了问题。碰巧，我在 Atlassian Premier Support 工作，因此我跟踪了完整的文档注释（代码搜索），以便您阅读：

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