Fixed #13202 -- Documented required libraries for markup template tags, based on patch from steveed.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12860 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
8f3d6b9404
commit
2881da949f
|
@ -143,22 +143,27 @@ markup
|
||||||
|
|
||||||
A collection of template filters that implement common markup languages:
|
A collection of template filters that implement common markup languages:
|
||||||
|
|
||||||
* ``textile`` -- implements `Textile`_
|
* ``textile`` -- implements `Textile`_ -- requires `PyTextile`_
|
||||||
* ``markdown`` -- implements `Markdown`_
|
* ``markdown`` -- implements `Markdown`_ -- requires `Python-markdown`_
|
||||||
* ``restructuredtext`` -- implements `ReST (ReStructured Text)`_
|
* ``restructuredtext`` -- implements `ReST (ReStructured Text)`_
|
||||||
|
-- requires `doc-utils`_
|
||||||
|
|
||||||
In each case, the filter expects formatted markup as a string and returns a
|
In each case, the filter expects formatted markup as a string and returns a
|
||||||
string representing the marked-up text. For example, the ``textile`` filter
|
string representing the marked-up text. For example, the ``textile`` filter
|
||||||
converts text that is marked-up in Textile format to HTML.
|
converts text that is marked-up in Textile format to HTML.
|
||||||
|
|
||||||
To activate these filters, add ``'django.contrib.markup'`` to your
|
To activate these filters, add ``'django.contrib.markup'`` to your
|
||||||
:setting:`INSTALLED_APPS` setting. Once you've done that, use ``{% load markup %}`` in
|
:setting:`INSTALLED_APPS` setting. Once you've done that, use
|
||||||
a template, and you'll have access to these filters. For more documentation,
|
``{% load markup %}`` in a template, and you'll have access to these filters.
|
||||||
read the source code in django/contrib/markup/templatetags/markup.py.
|
For more documentation, read the source code in
|
||||||
|
:file:`django/contrib/markup/templatetags/markup.py`.
|
||||||
|
|
||||||
.. _Textile: http://en.wikipedia.org/wiki/Textile_%28markup_language%29
|
.. _Textile: http://en.wikipedia.org/wiki/Textile_%28markup_language%29
|
||||||
.. _Markdown: http://en.wikipedia.org/wiki/Markdown
|
.. _Markdown: http://en.wikipedia.org/wiki/Markdown
|
||||||
.. _ReST (ReStructured Text): http://en.wikipedia.org/wiki/ReStructuredText
|
.. _ReST (ReStructured Text): http://en.wikipedia.org/wiki/ReStructuredText
|
||||||
|
.. _PyTextile: http://loopcore.com/python-textile/
|
||||||
|
.. _Python-markdown: http://www.freewisdom.org/projects/python-markdown
|
||||||
|
.. _doc-utils: http://docutils.sf.net/
|
||||||
|
|
||||||
messages
|
messages
|
||||||
========
|
========
|
||||||
|
|
Loading…
Reference in New Issue