在最新學(xué)習(xí)python中空凸,使用django搭建博客系統(tǒng),管理后臺直接使用django自帶的admin模塊,所以遇到富文本編輯的問題我注,經(jīng)過查閱資料,發(fā)現(xiàn)了django-ckeditor這個小插件迟隅,下面小威就分享一點點來自小白的經(jīng)驗吧~
首先安裝django-ckeditor
pip install django-ckeditor
其次但骨,需要安裝pillow(pillow是python的一個圖形處理庫,此次用到的django-ckeditor需要依賴此庫)
pip install pillow
安裝好后智袭,就是要進行django的配置奔缠,大致配置步驟如下:
- 在settings.py文件中,將“ckeditor”和“ckeditor_uploader”加入到“INSTALLED_APPS”中
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'blog.apps.BlogConfig',
'ckeditor',
'ckeditor_uploader'
]
- 在settings.py中配置“CKEDITOR_UPLOAD_PATH
MEDIA_URL = '/'
CKEDITOR_UPLOAD_PATH = 'static/upload/article_images'
CKEDITOR_IMAGE_BACKEND = 'pillow'
- 如果在富文本編輯框里有代碼高亮等其他自定義的功能吼野,還需要在settings.py里配置“CKEDITOR_CONFIGS”的配置項
CKEDITOR_CONFIGS = {
'default': {
'toolbar': (['div', 'Source', '-', 'Save', 'NewPage', 'Preview', '-', 'Templates'],
['Cut', 'Copy', 'Paste', 'PasteText', 'PasteFromWord', '-', 'Print', 'SpellChecker', 'Scayt'],
['Undo', 'Redo', '-', 'Find', 'Replace', '-', 'SelectAll', 'RemoveFormat', '-', 'Maximize',
'ShowBlocks', '-', "CodeSnippet", 'Subscript', 'Superscript'],
['Form', 'Checkbox', 'Radio', 'TextField', 'Textarea', 'Select', 'Button', 'ImageButton',
'HiddenField'],
['Bold', 'Italic', 'Underline', 'Strike', '-'],
['NumberedList', 'BulletedList', '-', 'Outdent', 'Indent', 'Blockquote'],
['JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock'],
['Link', 'Unlink', 'Anchor'],
['Image', 'Flash', 'Table', 'HorizontalRule', 'Smiley', 'SpecialChar', 'PageBreak'],
['Styles', 'Format', 'Font', 'FontSize'],
['TextColor', 'BGColor'],
),
'extraPlugins': 'codesnippet',
}
}
- 在urs.py中增加ckeditor的url配置
from django.urls import path,include,re_path
urlpatterns = [
url(r'^ckeditor/',include('ckeditor_uploader.urls'))
]
這里的話校哎,我所有上傳的圖片文件保存路徑都是在static目錄下的,附帶再貼下我靜態(tài)資源加載的目錄配置吧瞳步,大概修改了兩個文件:
修改settings.py:
STATIC_URL = '/static/'
STATIC_ROOT = 'static'
在urls.py中的“urlpatterns”添加配置:
from django.views import static
from django.conf import settings
urlpatterns = [
url(r'^static/(?P<path>.*)$',static.serve,
{'document_root':settings.STATIC_ROOT},name='static'),
]
以上配置中闷哆,“CKEDITOR_UPLOAD_PATH”主要是設(shè)置通過ckeditor上傳的圖片所存放的目錄,這里的路徑是一個相對路徑喲单起,相對于設(shè)置的“MEDIA_URL”抱怔。這塊有啥具體問題建議還是可以前往django官方文檔查看喲~
至此,我們的配置已經(jīng)完成了嘀倒,那接下來我們是不是可以愉快的是用了呢野蝇?恭喜你,打錯了~~~
在我們配置完成后括儒,需要在于manage.py的目錄下使用命令運行“manage.py collectstatic”绕沈,將ckeditor的靜態(tài)資源下載到項目工程下。
ok~做完以上帮寻,就可以愉快的玩耍了乍狐。
- 首先在模型里先引入:from ckeditor_uploader.fields import RichTextUploadingField(此處需要注意的是,ckeditor.fields.RichTextUploadingField是不能上傳圖片的)
- 然后把你需要是富文本的字段修改下即可固逗,如:content = RichTextUploadingField(verbose_name='內(nèi)容')
from ckeditor_uploader.fields import RichTextUploadingField
class Article(models.Model):
#content = models.TextField(verbose_name='內(nèi)容')
content = RichTextUploadingField(verbose_name='內(nèi)容')
至此浅蚪,啟動應(yīng)用藕帜,就可以看到原本內(nèi)容的文本輸入框變成了富文本編輯框,腫么樣惜傲,雞不雞凍~~
寫在最后洽故,使用ckeditor編輯的內(nèi)容在前端顯示的時候,需要再頁面頭部引入js文件
<script src="{% static 'ckeditor/ckeditor/plugins/codesnippet/lib/highlight/highlight.pack.js' %}"></script>
如果需要代碼高亮的樣式盗誊,還需首先引入css樣式文件
<link rel="stylesheet" href="{% static 'ckeditor/ckeditor/plugins/codesnippet/lib/highlight/styles/monokai_sublime.css' %}">
然后再引入js文件:
<script src="{% static 'ckeditor/ckeditor/plugins/codesnippet/lib/highlight/highlight.pack.js' %}"></script>
最后在script標簽寫入如下js代碼
hljs.initHighlightingOnLoad();
但是僅此你還會發(fā)現(xiàn)前端顯示的是原始的html標簽泄鹏,我們在變量中加入safe過濾就闊以啦~比如
{{content|safe}}
emmm到這里寥袭,小威的分享就結(jié)束了拱镐,還有神馬疑問的慢显,歡迎給我留言喲,一起交流开镣,共同進步喵刀诬,就是醬紫~