在Django admin后台添加数据的时候,文章内容文本框想发布一篇图文并茂的文章需就得手写Html代码,这十分吃力,也没法上传图片和文件。这显然不是我等高大上程序猿想要的。

Django 3.2.5博客开发教程:使用富文本编辑器添加数据_上传

为提升效率,我们可以使用富文本编辑器添加数据。支持Django的富文本编辑器很多,这里我推荐使用DjangoUeditor,Ueditor是百度开发的一个富文本编辑器,功能强大。下面教大家安装如何使用DjangoUeditor。

1、首先我们先下载DjangoUeditor包。点击下面的链接进行下载!下载完成然后解压到项目根目录里。

Django 3.2.5博客开发教程:使用富文本编辑器添加数据_上传_02​​​DjangoUeditor.zip​

2、settings.py里注册APP,在INSTALLED_APPS里添加’DjangoUeditor’。

​myblog/settings.py​

INSTALLED_APPS = [
'django.contrib.admin',
....
'DjangoUeditor', #注册APP应用
]

3、myblog/urls.py里添加url。

​myblog/urls.py​

from django.urls import path, include
#留意上面这行比原来多了一个include

urlpatterns = [
path('admin/', admin.site.urls),
path('', views.hello),
path('ueditor/', include('DjangoUeditor.urls')), #添加DjangoUeditor的URL
]

4、修改blog/models.py里需要使用富文本编辑器渲染的字段。这里面我们要修改的是Article表里的body字段。

把原来的:

​blog/models.py​

body = models.TextField()

修改成:

​blog/models.py​

from DjangoUeditor.models import UEditorField #头部增加这行代码导入UEditorField

body = UEditorField('内容', width=800, height=500,
toolbars="full", imagePath="upimg/", filePath="upfile/",
upload_settings={"imageMaxSize": 1204000},
settings={}, command=None, blank=True
)

Django 3.2.5博客开发教程:使用富文本编辑器添加数据_上传_03

留意里面的imagePath=“upimg/”, filePath=“upfile/” 这两个是图片和文件上传的路径,我们上传文件,会自动上传到项目根目录media文件夹下对应的upimg和upfile目录里,这个目录名可以自行定义。有的人问,为什么会上传到media目录里去呢?那是因为之前我们在​​基础配置​​文章里,设置了上传文件目录media。

上面步骤完成后,我们启动项目,进入文章发布页面。提示出错:

render() got an unexpected keyword argument 'renderer'

Django 3.2.5博客开发教程:使用富文本编辑器添加数据_django_04

错误页面上有提示,出错的地方是下面文件的93行。

F:\course\myblog\myblogvenv\lib\site-packages\django\forms\boundfield.py in as_widget, line 93

我这里使用的是最新版本的Django2.1.1所以报错,解决办法很简单。打开这个文件的93行,注释这行即可。

Django 3.2.5博客开发教程:使用富文本编辑器添加数据_上传_05

修改成之后,重新刷新页面,就可以看到我们的富文本编辑器正常显示。

Django 3.2.5博客开发教程:使用富文本编辑器添加数据_富文本编辑器_06

留意,如果我们在富文本编辑器里,上传图片,在编辑器内容里不显示上传的图片。那我们还需要进行如下设置,打开myblog/urls.py文件,在里面输入如下代码:

​myblog/urls.py​

from django.urls import path, include, re_path
#上面这行多加了一个re_path
from django.views.static import serve
#导入静态文件模块
from django.conf import settings
#导入配置文件里的文件上传配置

urlpatterns = [
path('admin/', admin.site.urls),
....
re_path('^media/(?P<path>.*)$', serve, {'document_root': settings.MEDIA_ROOT}),#增加此行
]

设置好了之后,图片就会正常显示。这样我们就可以用DjangoUeditor富文本编辑器发布图文并茂的文章了。

参考链接:​​Django博客开发教程:使用富文本编辑器添加数据​