各种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类。

您可能会注意到上述文档中的某些描述被截断。它们只是Javadoc提供的文档注释，因此出现了问题。碰巧，我为Atlassian Premier Support工作，所以我已经找到了完整的文档评论（yay code search），以便您阅读愉快：

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