Skip to main content

A generic Django application to convert text with specific markup to html.

Project description

https://travis-ci.org/bartTC/django-markup.svg?branch=master https://codecov.io/github/bartTC/django-markup/coverage.svg?branch=master

django-markup

This app is a generic way to provide filters that convert text into html.

The documentation is available at http://readthedocs.org/docs/django-markup/en/latest/

Quickstart

Download and install the package from the python package index (pypi):

pip install django-markup

Note that django-markup ships with some filters ready to use, but the requirements of those filters are not installed by default! If you want to use all of the filters right away, you can install their latest packages with:

pip install textile smartypants docutils markdown python-creole

Then add it to the INSTALLED_APPS list:

INSTALLED_APPS = (
    ...
    'django_markup',
)

Use it in the template:

{% load markup_tags %}
{{ the_text|apply_markup:"markdown" }}

Or in Python code:

from django_markup.markup import formatter
formatter('Some *Markdown* text.', filter_name='markdown')

Testsuite

To run the testsuite simply run python setup.py test which will invoke a Tox collection testing against various Python and Django versions.

For a specific local installation run python runtests.py.

Changelog

v1.2 (2017-03-18):

  • Django 1.10 compatibility and tests.

  • Updated all filter dependencies. most notably SmartyPants to v2.0 which changed it’s API, so your project dependencies need to update it as well.

v1.1 (2016-05-02):

  • The Markdown filter has the safe_mode option enabled by default.

  • The RestructuredText filter has the file and raw content inclusion disabled by default.

v1.0 (2016-01-02):

  • Removed some 5 year old dust

  • Django 1.8+ compatible

  • Tests

Backwards incompatible changes:

  • Removed Pygments highlighting in the Markdown and RestructuredText filter.

  • Removed CreoleParser library in favor of a pypi package.

  • Removed Lightbox filter.

  • The RestructuredText filter now renders level 1 and 2 headers. See Github Issue 14 for details and a backwards compatible workaround.

v0.4 (2011-06-01):

  • Added a widont filter

  • MarkupField is South compatible.

  • Tested with Django 1.3

v0.3 (2009-07-29):

django-markup now ships with a builtin creole parser. Advantage is, that the recently used Creoleparser library needs the Genshi lib, which needs a c-compiler and so on. The builtin creole parser is a pure python library without any dependencies and follows the wikicreole.org specifications. django-markup uses the WikiCreole library.

Project details


Download files

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

Source Distribution

django-markup-1.2.tar.gz (22.0 kB view details)

Uploaded Source

File details

Details for the file django-markup-1.2.tar.gz.

File metadata

  • Download URL: django-markup-1.2.tar.gz
  • Upload date:
  • Size: 22.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-markup-1.2.tar.gz
Algorithm Hash digest
SHA256 4ef5d268d9376253513f3a7897ac15da48795412b34c8c9c4b9ef0a472ff21b7
MD5 3c92609b5bbc3da855ab5392a8b16fbd
BLAKE2b-256 2babc8d200bcb66dc82bd0e8c4c38078fb68256aa072502a9882dd5bd250d5b2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page