← Back to branch summary

~ubuntu-branches/debian/sid/python-django/sid

« back to all changes in this revision

Viewing changes to docs/ref/contrib/markup.txt

  • Committer: Package Import Robot
  • Author(s): Luke Faraone, Jakub Wilk, Luke Faraone
  • Date: 2013-05-09 15:10:47 UTC
  • mfrom: (6.2.12 experimental)
  • Revision ID: package-import@ubuntu.com-20130509151047-g79qsrewg1yl43h5
Tags: 1.5.1-2
[ Jakub Wilk ]
* Use canonical URIs for Vcs-* fields.

[ Luke Faraone ]
* Upload to unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/ref/contrib/markup.txt
5
5
.. module:: django.contrib.markup
6
6
   :synopsis: A collection of template filters that implement common markup languages.
7
7
 
 
8
.. deprecated:: 1.5
 
9
    This module has been deprecated.
 
10
 
8
11
Django provides template filters that implement the following markup
9
12
languages:
10
13
 
11
14
* ``textile`` -- implements `Textile`_ -- requires `PyTextile`_
12
 
* ``markdown`` -- implements `Markdown`_ -- requires `Python-markdown`_
 
15
* ``markdown`` -- implements `Markdown`_ -- requires `Python-markdown`_ (>=2.1)
13
16
* ``restructuredtext`` -- implements `reST (reStructured Text)`_
14
17
  -- requires `doc-utils`_
15
18
 
62
65
 
63
66
The Python Markdown library supports options named "safe_mode" and
64
67
"enable_attributes". Both relate to the security of the output. To enable both
65
 
options in tandem, the markdown filter supports the "safe" argument.
 
68
options in tandem, the markdown filter supports the "safe" argument::
66
69
 
67
70
    {{ markdown_content_var|markdown:"safe" }}
68
71
 
69
72
.. warning::
70
73
 
71
74
    Versions of the Python-Markdown library prior to 2.1 do not support the
72
 
    optional disabling of attributes and by default they will be included in
73
 
    any output from the markdown filter - a warning is issued if this is the
74
 
    case.
 
75
    optional disabling of attributes. This is a security flaw. Therefore,
 
76
    ``django.contrib.markup`` has dropped support for versions of
 
77
    Python-Markdown < 2.1 in Django 1.5.