skip to navigation
skip to content

django-sirtrevor 0.1.4

A simple Django app that provides a model field and corresponding widget based on the fantastic Sir Trevor project

Latest Version: 0.2.4

django-sirtrevor is a simple Django app that provides a content editing widget based on the fantastic Sir Trevor project.

IMPORTANT: This package should be considered (pre-)alpha. It is by no means feature-complete or bug-free. It is a work-in-progress and right now lacks some key features.

Quick start

  1. Install django-sirtrevor:

    pip install django-sirtrevor
  2. Add sirtrevor to your INSTALLED_APPS setting like this:

  3. Create a model that makes use of SirTrevorField:

    from django.db import models
    from sirtrevor.fields import SirTrevorField
    class MyModel(models.Model):
        content = SirTrevorField()
  4. Now you can …

    • see it in action in the Django admin
    • create a ModelForm from your model
    • create a plain Form and use sirtrevor.forms.SirTrevorFormField
    • use sirtrevor.widgets.SirTrevorWidget as a widget replacement for a Textarea


Sir Trevor has a few configuration options. You can customize most of them project-wide in your or on a per-widget basis as kwargs for SirTrevorWidget.

Available options (CONFIGURATION_SETTINGS / widget_kwargs):

SIRTREVOR_BLOCK_TYPES / st_block_types
Specify an array of block types to use with the editor. Defaults to ['Text', 'List', 'Quote', 'Image', 'Video', 'Tweet', 'Heading']
SIRTREVOR_DEFAULT_TYPE / st_default_type
Specify a default block to start the editor with. Defaults to None
SIRTREVOR_BLOCK_LIMIT / st_block_limit
Set an overall total number of blocks that can be displayed. Defaults to 0
SIRTREVOR_BLOCK_TYPE_LIMITS / st_block_type_limits
Set a limit on the number of blocks that can be displayed by its type. Defaults to {}
Specify which block types are required for validatation. Defaults to None



File Type Py Version Uploaded on Size
django-sirtrevor-0.1.4.tar.gz (md5) Source 2014-03-18 417KB