Drupal Canvas Full HTML 部署指南

Source: Dev.to

为什么我会构建它

Canvas 自带强大的编辑器，但如果配置不当，在 Canvas 中使用 Full HTML 可能存在风险。我想要一个确定性的、一步步的指南，使部署过程安全且可审计，并提供一个具体的参考实现供指向。

解决方案

我将指南提炼为可预测的顺序，并映射到实际代码：

• 验证前置条件（Drupal 11.2+、Canvas 1.0.4、Full HTML 文本格式）
• 安装 Canvas 和 Canvas Full HTML
• 启用 Gin 以获得一致的编辑基线
• 在 Canvas 中配置 Full HTML 并清除缓存

验证组件模式是否公开 contentMediaType: text/html，并确认 Canvas AI 行为和提示模式，以安全使用组件。

props:
  type: object
  properties:
    content:
      type: string
      title: Content
      contentMediaType: text/html
      x-formatting-context: block

代码

我构建了一个小模块/演示，映射了部署步骤和模式期望。你可以克隆它或在此处浏览关键文件：View Code

我的收获

• Canvas Full HTML 支持 Drupal ^10.3 和 ^11，但稳定版 Canvas 目标为 ^11.2，因此版本对齐很重要。
• Gin 管理主题显著提升了 Canvas 的创作体验。
• 当提示强调“放置”而非“创建”时，Canvas AI 更安全，能够减少意外的组件生成。

参考资料

• Canvas Full HTML Module Addresses Rich Text Limitations in Drupal Canvas
• 最初发布于 VictorStack AI Blog