django-richtextfield 1.6.2

JavaScript源

'js'

所需JavaScript文件列表。这些可以是CDN的URL或相对于你的STATIC_URL的路径，例如。

'js': ['//cdn.ckeditor.com/4.14.0/standard/ckeditor.js']

或者

'js': ['path/to/editor.js', 'path/to/plugin.js']

CSS源文件

'css'

所需CSS文件的字典。这些可以是CDN的URL或相对于你的STATIC_URL的路径，例如。

'css': {
    'all': [
        'https://cdn.example.com/css/editor.css'
    ]
}

或者

'css': {'all': ['path/to/editor.css', 'path/to/plugin.css']}

编辑器初始化模板

'init_template'

到你的编辑器初始化模板的路径。目前django-richtextfield附带两个模板，任选其一

'init_template': 'djrichtextfield/init/tinymce.js'

或者

'init_template': 'djrichtextfield/init/ckeditor.js'

编辑器设置

'settings'

一个Python字典，包含你的编辑器的默认配置数据，例如。

'settings': {  # TinyMCE
    'menubar': False,
    'plugins': 'link image',
    'toolbar': 'bold italic | link image | removeformat',
    'width': 700
}

或者

'settings': {  # CKEditor
    'toolbar': [
        {'items': ['Format', '-', 'Bold', 'Italic', '-',
                   'RemoveFormat']},
        {'items': ['Link', 'Unlink', 'Image', 'Table']},
        {'items': ['Source']}
    ],
    'format_tags': 'p;h1;h2;h3',
    'width': 700
}

编辑器配置文件

'profiles'

这是一个可选的配置键。配置文件是“命名”的定制设置，用于配置特定类型的字段。你可以这样配置配置文件

'profiles': {
    'basic': {
        'toolbar': 'bold italic | removeformat'
    },
    'advanced': {
        'plugins': 'link image table code',
        'toolbar': 'formatselect | bold italic | removeformat |'
                   ' link unlink image table | code'
    }
}

内容清理器

'sanitizer'

这是一个可选的配置键。清理器可以在小部件返回值之前处理提交的值。默认情况下，不会对提交的值执行任何处理。你可以通过提供函数或可导入的函数路径来配置清理器，如下所示

'sanitizer': lambda value: '<h1>Title</h1>' + value

或者

'sanitizer': 'bleach.clean'

'sanitizer_profiles'

这是一个可选的配置键。可以为配置的每个配置文件覆盖默认或配置的清理器。例如，要为advanced配置文件设置自定义清理器

'sanitizer_profiles': {
    'advanced': lambda value: value + 'This text has been sanitized.'
}

初始化模板

初始化模板是一个Django模板（因此它应该在模板中，而不是在静态目录中）。它包含一些用于初始化每个编辑器的JavaScript代码。例如，Summernote的初始化模板可能如下所示

$('#' + id).summernote(settings)

初始化模板有以下JavaScript变量可供外部作用域使用

field

要替换的textarea的DOM节点

id

textarea的id属性

default_settings

DJRICHTEXTFIELD_CONFIG['settings']作为一个JS对象

custom_settings

field_settings作为一个JS对象

settings

default_settings和custom_settings的合并

1.6.2 (2024-03-07)

• 代码刷新，没有功能更改

• 将CI切换到GitHub动作

• 使用Django 3.2和4.2进行测试

• 使用Python 3.8、3.10和3.12进行测试

• 放弃对旧版Python和Django版本的支持

1.6.1 (2021-04-14)

• 支持Django 3.2（无需更改）

• 使用Django主版本（4.0）进行测试

• 使用force_str代替force_text，因为后者在Django 4.0中被弃用并删除

1.6 (2020-05-20)

• init.js不再依赖于jQuery。这可能会对以下用户造成不兼容的向后兼容性更改

  • 定义了自己的init脚本并依赖于$e变量。此变量已被替换为field，它是一个纯DOM节点而不是jQuery对象。

  • 依赖于Django捆绑版jQuery的隐式加载的用户现在必须显式地加载它。

• 已验证TinyMCE init/config与TinyMCE 4和5兼容

• 已测试并验证与Django 3.1兼容

1.5.0 (2019-12-04)

• 放弃对Python 2的支持

• 放弃对Django < 2.2的支持

• 添加对Django 3.0的支持

1.4.0 (2019-01-31)

• 注意：这是支持Python 2的最后一个版本！

• 添加对可插拔服务器端内容清理器的支持

1.3.0 (2018-11-05)

• 允许CSS文件通过RichTextWidget包含

1.2.4 (2018-09-25)

• 修复Django 2.1的admin界面显示问题

1.2.3 (2018-09-11)

• 添加对Django 2.1的支持

1.2.2 (2018-06-12)

• 根据DEBUG条件加载未压缩/压缩版本的jQuery

• 在所有其他脚本之前加载jQuery

1.2.1 (2018-01-18)

• 将['admin/js/vendor/jquery/jquery.min.js', 'admin/js/jquery.init.js']添加到RichTextWidget.media.js中。这使得小部件可以在admin之外使用（但仍需要django.contrib.admin在INSTALLED_APPS中），并防止在特定边缘情况下在admin中发生JavaScript错误。

1.2 (2017-12-04)

• 移除对Django < 1.11的支持

• 添加对Django 2.0的支持

1.1 (2016-01-14)

• 移除对Django < 1.8的支持

• 与Django 1.8和Django 1.9进行了测试

1.0.1 (2014-11-13)

• 修复Unicode错误

1.0 (2014-09-30)

• 第一个版本