django-trumbowyg is the Django-related reusable app for integrating Trumbowyg WYSIWYG editor. It is recognized as one of the best WYSIWYG editors.
Install
django-trumbowyg
usingpip
:$ pip install django-trumbowyg
Add
'trumbowyg'
to yourINSTALLED_APPS
setting:INSTALLED_APPS = ( ... 'trumbowyg', ... )
Update your
urls.py
:url(r'^trumbowyg/', include('trumbowyg.urls'))
Sometimes you might want to limit size of uploaded images, e.g. if they are too large. In this case just put in settings (if you omit this, the image will be uploaded unchanged):
TRUMBOWYG_THUMBNAIL_SIZE = (1920, 1080)
The package will try to use the language defined in
LANGUAGE_CODE
and if this language isin't availabe the default isen
(Optional) If you wish image filenames to be transliterated, install unidecode from PyPi and set:
TRUMBOWYG_TRANSLITERATE_FILENAME = True
Set semantics if necessary. It defaults to
false
:TRUMBOWYG_SEMANTIC = 'true'
Don't forget to add
{{ form.media }}
to form template.
Use TrumbowygWidget
in your forms:
from django.forms import ModelForm from django.contrib.admin import ModelAdmin from trumbowyg.widgets import TrumbowygWidget from your_app.models import YourModel class YourModelAdminForm(ModelForm): class Meta: model = YourModel widgets = { 'text': TrumbowygWidget(), } class YourModelAdmin(admin.ModelAdmin): form = YourModelAdminForm admin.site.register(YourModel, YourModelAdmin)