将页面从 Paragraphs 移到 DXPR Builder.

您将每页的段落重建为 DXPR Builder 元素，在同一内容类型的新字段中。段落保持在线直到每页完成。之后，编辑人员在页面本身上设计页面，而非填写段落表单。没有工具转换段落，但 Drush 可一次将准备好的 HTML 写入多页。

开始之前

• DXPR Builder 已安装且产品密钥已保存，参见 常规设置。
• 可管理内容类型的字段和显示。
• 内容类型的每个页面一旦显示使用 DXPR Builder 格式化器即计为一个内容项。在以下位置查看您的上限 Content Items 选项卡。

设置

1. 前往 Structure > Content types (/admin/structure/types），然后点击 Manage fields 针对内容类型。
2. 添加字段：选择 Formatted text，然后 Long text，例如 "Page content"。
3. 点击 Manage display 并设置 Format 新字段设为 DXPR Builder.
4. 将 Paragraphs 字段留在原处并点击 Save.

重建每个页面

1. 打开页面。空白 DXPR Builder 字段显示在段落旁边。
2. 用下表匹配的元素重建每个段落。
3. 将每个段落的文本复制到新元素中。
4. 点击 Save 在 DXPR Builder 工具栏上。

用 Drush 重建多页

DXPR Builder 将 Bootstrap 5 HTML 变成可拖拽编辑的元素。如果能将旧内容导出为 HTML，请用 Drush 将其写入每个页面。请通过以下方式尝试 --dry-run 首先尝试，它显示更改而不保存：

drush dxb:page:update 42 --markup=@/tmp/page-42.html --dry-run
drush dxb:page:update 42 --markup=@/tmp/page-42.html

该命令在内容类型的默认显示中找到 DXPR Builder 字段。它保存新修订，因此可以回滚。

完成迁移

1. On Manage display，将 Paragraphs 字段移到 Disabled 并点击 Save.
2. 检查重建的页面，手机上也要检查。
3. 删除以下位置的 Paragraphs 字段 Manage fields 仅在不再需要其内容时。删除会彻底移除段落。

您会看到的内容

每个页面显示 DXPR Builder 字段的内容，段落不再出现。拥有以下权限的编辑人员 Edit with DXPR Builder 权限在页面上看到编辑控件。Content items 选项卡列出该内容类型的每个页面。

如果您看不到编辑器

• 页面显示旧内容和新内容。 Paragraphs 字段仍在显示上。将其移到 Disabled：Manage display.
• Drush 报告 "No DXPR Builder field found"。 默认显示不使用 DXPR Builder 格式化器。设置 Format：Manage display 默认视图模式的。
• Drush 报告 "Multiple DXPR Builder fields found"。 该内容类型有多个。命名字段，例如 --field=field_page_content.
• 字段显示，但没有编辑控件。 您的账户缺少 Edit with DXPR Builder 权限，或许可证上限已达。参见 许可和产品密钥错误。

接下来做什么？

• 从 Layout Builder：针对 Layout Builder 页面的相同迁移
• 元素选择器：您可以使用的每个元素