redturtle.importer.volto 1.0.0

功能

为具有启用 volto.blocks 行为的内容类型，为 redturtle.importer.base 提供了一个新的适配器，它将富文本从html (TinyMce) 转换为json (DraftJs/blocks)。

HTML到DraftJs转换器

对于启用了块的内容类型，我们需要将旧式HTML文本转换为DraftJs兼容的数据结构。

完成此操作的最佳库是官方库，仅适用于JavaScript。

因此，为了转换HTML，我们需要在我们的buildout中设置一个环境变量，其中包含其地址：https://github.com/RedTurtle/draftjs-converter

这是一个接受一些HTML并返回其DraftJs转换版本的nodejs rest api。

要使用此API，我们需要在我们的buildout中设置一个环境变量，其中包含其地址。

environment-vars +=
    ...
    DRAFTJS_CONVERTER_URL http://localhost:3000/html_converter

块转换

RichText值中的每一部分都应该转换为Volto块元素。

某些部分可以转换为特定的块（例如表格、图片、嵌入项）。其他标准HTML元素则转换为包含DraftJs数据结构的 text 块。

在将文本转换为块时，我们做了一些假设。

类型转换

如果内容类型启用了volto.blocks行为并且有一个text字段，该字段将转换为块。

Collection内容类型将被转换为带有其条件过滤器的Document。

具有默认视图的Folders将被转换为具有这些规则的Document内容类型。

• 如果默认视图是Collection内容类型，我们将创建一个带有其条件过滤器的listing block。

• 如果默认视图是Document或News Item，我们将将其文本转换为块。

• 如果文件夹没有默认项目作为视图，我们将创建一个显示一级内容的listing block。

安装

通过将其添加到您的buildout中安装redturtle.importer.volto

[buildout]

...

eggs =
    redturtle.importer.volto

然后运行bin/buildout

您不必安装它。这样，在数据迁移之后，您可以从buildout中删除它，并且一切都很干净。

鸣谢

本产品是在以下机构的帮助下开发的

贡献者

• RedTurtle Technology, sviluppoplone@redturtle.it

变更日志

1.0.0 (2020-12-18)

• 初始发布。 [cekk]