在Wagtail 2.0的Draftail编辑器中添加上标功能的技术问询

嘿，我来帮你一步步解决这些Draftail上标功能的问题：

1. 示例代码应该放在哪里？ #

你需要把自定义Rich Text功能的代码放在任意一个已安装Wagtail app的wagtail_hooks.py文件里——如果你的app还没有这个文件，直接新建一个就行。Wagtail会自动扫描所有已安装app中的该文件，加载里面注册的钩子和功能。

举个例子，假设你的项目主app叫my_site，就在my_site/wagtail_hooks.py中编写注册代码即可。

2. 修改Strikethrough示例为上标配置是否可行？ #

完全可行！只需要把示例中跟删除线相关的配置替换为上标的对应参数就行。这里给你一个完整的上标功能注册代码：

from wagtail.rich_text import features as richtext_features
from wagtail.admin.rich_text.editors.draftail import features as draftail_features
from wagtail.core import hooks

@hooks.register('register_rich_text_features')
def register_superscript_feature(features):
    feature_name = 'superscript'
    type_ = 'SUPERSCRIPT'

    # 配置Draftail编辑器的按钮与行为
    control = {
        'type': type_,
        'label': 'x²',
        'description': '上标',
        # Draftail内置了superscript图标，直接调用即可
        'icon': 'superscript',
    }
    draftail_features.register_editor_plugin(
        'draftail', feature_name, draftail_features.InlineStyleFeature(control)
    )

    # 告诉Wagtail如何转换编辑器内容与HTML格式
    features.register_converter_rule('contentstate', feature_name, {
        'from_database_format': {'sup': {'type': type_}},
        'to_database_format': {
            'style_map': {
                type_: {'element': 'sup'},
            }
        }
    })

    # 可选：将该功能加入全局默认feature列表，无需手动给每个字段添加
    features.default_features.append(feature_name)

核心修改点：

• 用feature_name='superscript'作为功能标识
• 用type_='SUPERSCRIPT'匹配Draftail的内部样式类型
• 绑定HTML标准的<sup>标签作为上标的渲染载体

3. 是否需要修改所有RichTextField以启用该功能？ #

分两种场景处理：

• 给特定字段开启上标：需要在定义RichTextField时，把'superscript'添加到features参数中，示例：

  from wagtail.core.fields import RichTextField
  
  class MyPage(Page):
      body = RichTextField(features=['bold', 'italic', 'superscript'])
  

• 全局默认开启上标：在项目settings.py中修改Wagtail富文本编辑器配置，把'superscript'加入默认feature列表：

  WAGTAILADMIN_RICH_TEXT_EDITORS = {
      'default': {
          'WIDGET': 'wagtail.admin.rich_text.DraftailRichTextArea',
          'OPTIONS': {
              'features': ['bold', 'italic', 'link', 'superscript']
          }
      },
  }
  

这样所有默认的RichTextField都会自动带上标功能，无需逐个修改。

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