Wagtail 4.1.1项目中Draftail入门Mark按钮插件无法生效

可能的原因及对应解决方案 #

1. 应用未在INSTALLED_APPS中注册 #

Wagtail仅会加载已注册应用内的wagtail_hooks.py文件。如果你的新建应用未加入settings.py的INSTALLED_APPS列表，钩子代码根本不会被执行。

解决：
打开项目根目录的settings.py，将你的应用名称添加到INSTALLED_APPS中：

INSTALLED_APPS = [
    # ... 其他已有应用
    'your_app_name',  # 替换为你的应用名称
    # ... Wagtail相关应用（如wagtail.admin、wagtail.core等）
]

2. RichTextField未启用Mark功能 #

默认的RichTextField使用Wagtail内置的默认富文本功能集合，不包含你新增的mark功能。必须显式指定字段要启用的功能，或者修改全局默认功能列表。

解决方法二选一：

• 方法一：直接在字段中指定features
  修改models.py中的body字段，将mark加入features列表：

body = RichTextField(
    null=True, 
    blank=True,
    features=['bold', 'italic', 'link', 'mark']  # 包含自定义的mark功能
)

• 方法二：全局添加Mark到默认功能
  在wagtail_hooks.py中，注册完Mark功能后，将其追加到默认features列表：

from wagtail import hooks
from wagtail.admin.rich_text.editors.draftail import DraftailEditorPlugin

@hooks.register('register_rich_text_features')
def register_mark_feature(features):
    feature_name = 'mark'
    type_ = 'MARK'

    control = {
        'type': type_,
        'label': 'Mark',
        'description': 'Highlight text',
        'icon': 'highlight',  # 可选：指定Wagtail内置图标
    }

    features.register_editor_plugin(
        'draftail', feature_name, DraftailEditorPlugin(
            feature_name=feature_name,
            type_=type_,
            control=control,
        )
    )

    # 将mark添加到全局默认功能集合
    features.default_features.append('mark')

3. 缓存导致的加载问题 #

浏览器缓存或Django开发服务器缓存可能导致新的编辑器配置未生效。

解决：

• 按Ctrl+Shift+R强制刷新浏览器，清除缓存
• 重启Django开发服务器

内容的提问来源于stack exchange，提问作者Kiwiheretic