Skip to main content

Some Basic extensions for django-contrib-flatpages

Project description

An extension to django.contrib.flatpages to provide

  • Better support for markdown and other similar markup formats. We provide support for Markdown but you can write your own parser to support rst or creole.
  • Optional support for the excellent markItUp jquery editor. This requires the installation django-markitup.
  • Easy inclusion of images in flatpages. Viewing Admin image thumbnails requires the installation of sorl-thumbnail.
  • The inclusion of HTML metatags such as keywords and descriptions in flatpages.
  • Content revisions.

Migrating you data to flapages_x should not be difficult since the data which currently in the contrib.Flatpage model (content, titles) is not affected. Your templates will still utilize the {{flatpage.content}} and {{flatpage.body}} context variables. Once you install flatpages_x, the Markdown is actually stored in the related Revisions model. When you save a flatpage, this will be rendered as html via the markdown parser and saved to the Flatpage.content field


Create a virtual environment for your project and activate it:

$ virtualenv mysite-env
$ source mysite-env/bin/activate

Next install flatpages_x

(mysite-env)$ pip install django-flatpages-x

Add flatpages_x to your INSTALLED_APPS setting.

Inside your project run:

(mysite-env)$ python syncdb

Django-flatpages-x comes with support for Markdown You can also associate and display images with your flatpages. To include your images in your content using reference-style image syntax looks like this

![Atl text][]

Where [] is the primary key of image the that you want to include. The primary key of the image should is visible in the flatpages Admin form which will now contains an inline image form

markItUp support

If you want to use the excellent markItUp! editor widget. Install django-markItUp:

(mysite-env)$ pip install django-markitup

You need a few configuration steps

  1. Add ‘markitup’ to your INSTALLED_APPS setting.

  2. Add the following to settings:

    MARKITUP_SET = 'markitup/sets/markdown'
    MARKITUP_SKIN = 'markitup/skins/markitup'
    MARKITUP_FILTER = ('markdown.markdown', {'safe_mode': True})
  3. You need to use the AJAX-based preview for the admin widget:

    url(r'^markitup/', include('markitup.urls'))

in your root URLconf.

Admin thumbnails

If you want view admin image thumbnails install sorl-thumbnail:

(mysite-env)$ pip install sorl-thumbnail
  1. Add sorl.thumbnail to your settings.INSTALLED_APPS.

  2. Configure your settings

  3. If you are using the cached database key value store you need to sync the database:

    python syncdb

Markup Support

Django-flatpages-x come with a simple parser that supports Markdown. However, you can supply your own parser by setting the value for FLATPAGES_X_PARSER to So if you want to use a parser myparser_parser simply add the following to you settings

FLATPAGES_X_PARSER= ["flatpages_x.markdown_parser.parse", {}]


See the full documentation for more details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-flatpages-x, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size django_flatpages_x-0.1.5-py2-none-any.whl (12.4 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size django-flatpages-x-0.1.5.tar.gz (187.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page