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 모듈이 Drupal Canvas의 리치 텍스트 제한을 해결
• 원본 게시: VictorStack AI 블로그