Ńņ
IåHc @ sĄ d Z d d k Z d d k l Z l Z l Z l Z d d k i Z d d k i
Z d d d d g Z e i
d Z e i
d Z e i d
Z d Z
e d Z d
Z e d Z d S( s< Functions that convert from text markup languages to HTML.
i’’’’N( t HTMLt escapet literalt lit_subt markdownt textilizet nl2brt format_paragraphss
\r\n|\n|\rs \n{2,}s
c K s t t i | | S( sĄ Format the text to HTML with MarkDown formatting.
This function uses the `Python MarkDown library
`_
which is included with WebHelpers. It does not include extensions
due to circular import issues. If you need the footnotes or RSS
extensions, use the full Markdown package instead.
IMPORTANT:
If your source text is untrusted and may contain malicious HTML markup,
pass ``safe_mode="escape"`` to escape it, ``safe_mode="replace"`` to
replace it with a scolding message, or ``safe_mode="remove"`` to strip it.
There is at least one other Markdown package for Python. python-markdown2
(http://code.google.com/p/python-markdown2/), which claims to be faster and
to handle edge cases better. WebHelpers is sticking to the original Python
Markdown for now for backward compatibility and because nobody has
complained about the speed.
( R t _markdownR ( t textt kwargs( ( s> /usr/lib/python2.6/site-packages/webhelpers/html/converters.pyR s c C s% t i | } t | i d | S( s5 Format the text to HTML with Textile formatting.
This function uses the `PyTextile library `_
which is included with WebHelpers.
Additionally, the output can be sanitized which will fix tags like
![]()
,
and
for proper XHTML output.
t sanitize( t textilet TextilerR t process( R R t texer( ( s> /usr/lib/python2.6/site-packages/webhelpers/html/converters.pyR + s
c C sF | d j o t d St t d | } t | i d t } | S( s) Insert a
before each newline.
t s
N( t NoneR R t _universal_newline_rxR t replacet br( R ( ( s> /usr/lib/python2.6/site-packages/webhelpers/html/converters.pyR 8 s
c C s | d j o t d St t d | } t i | } xV t | D]H \ } } | o" t | } | i d t } n t i
| | | .
``preserve_lines``:
If true, add
before each single line break
R s
s
N( R R R R t
_paragraph_rxt splitt enumerateR R R t pt join( R t preserve_linest
paragraphst it para( ( s> /usr/lib/python2.6/site-packages/webhelpers/html/converters.pyR A s
( t __doc__t ret webhelpers.htmlR R R R t webhelpers.textileR t webhelpers.markdownR R t __all__t compileR R R t FalseR R R ( ( ( s> /usr/lib/python2.6/site-packages/webhelpers/html/converters.pyt s "