\2? @ s6 d Z d d l m Z d d l m Z d d l m Z m Z d d l Z d d l Z d d l Z d d l
m Z d d l m
Z
d d l m Z d d
l m Z d d l m Z d d l m Z d d
l m Z d d l m Z m Z d d d g Z e j d Z Gd d d e Z d d Z d d Z! d S)a
Python Markdown
===============
Python Markdown converts Markdown to HTML and can be used as a library or
called from the command line.
## Basic usage as a module:
import markdown
html = markdown.markdown(your_text_string)
See for more
information and instructions on how to extend the functionality of
Python Markdown. Read that before you try modifying this file.
## Authors and License
Started by [Manfred Stienstra](http://www.dwerg.net/). Continued and
maintained by [Yuri Takhteyev](http://www.freewisdom.org), [Waylan
Limberg](http://achinghead.com/) and [Artem Yunusov](http://blog.splyer.com).
Contact: markdown@freewisdom.org
Copyright 2007-2013 The Python Markdown Project (v. 1.7 and later)
Copyright 200? Django Software Foundation (OrderedDict implementation)
Copyright 2004, 2005, 2006 Yuri Takhteyev (v. 0.2-1.6b)
Copyright 2004 Manfred Stienstra (the original version)
License: BSD (see LICENSE for details).
)absolute_import)unicode_literals )version version_infoN)util)build_preprocessors)build_block_parser)build_treeprocessors)build_inlinepatterns)build_postprocessors) Extension)to_html_stringto_xhtml_stringMarkdownmarkdownmarkdownFromFileZMARKDOWNc @ s# e Z d Z d Z d Z i d d 6d d 6d d 6d d 6d d
6Z i e d 6e d 6e d
6e d 6e d 6e d 6Z d d d d d d d d d d d d d d d d g Z d! d" Z
d# d$ Z d% d& Z g d' d( Z
d) d* Z d+ d, Z d- d. Z d/ d0 Z d1 d1 d1 d2 d3 Z d1 S)4r zConvert Markdown to HTML.Zdivz[HTML_REMOVED]Zhtml_replacement_text Z
tab_lengthTenable_attributesZsmart_emphasisZlazy_olhtmlZhtml4Zhtml5Zxhtmlxhtml1Zxhtml5\`*_{}[]()>#+-.!c O sn d d d d g } d } xO | D]G } | | | k rF | | | | s z,Markdown.build_extension..,c S s. g | ]$ \ } } | j | j f q Sr@ )strip)rR rS yr@ r@ rA rT s r% zmarkdown.extensionsr Zmdxz/Failed loading extension '%s' from '%s' or '%s'z%Failed to initiate extension '%s': %s) dictfindrQ updatejoin
__import__
rpartition ImportErrorr9 Z
makeExtensionr- AttributeError) r8 Zext_namer* r; Zext_argsZpairs module_namemoduleZmodule_name_old_styleemessager@ r@ rA rI s: )
zMarkdown.build_extensionc C s | j j | | S)z# This gets called by the extension )r0 append)r8 extensionr@ r@ rA registerExtension s zMarkdown.registerExtensionc C sN | j j | j j x- | j D]" } t | d r$ | j q$ q$ W| S)zR
Resets all state variables so that we can start with a new text.
r7 )r4 r7 r3 clearr0 hasattr)r8 rf r@ r@ rA r7 s
zMarkdown.resetc C s | j | _ y | j | j | _ Wn t k
r } zh t | j j } | j d | j d d j | d f } | f | j d d | _ WYd d } ~ Xn X| S)z/ Set the output format for the class instance. z+Invalid Output Format: "%s". Use one of %s."z", "r N)
lowerr( output_formats
serializerKeyErrorlistkeyssortr\ r9 )r8 formatrc Z
valid_formatsrd r@ r@ rA r6 s
zMarkdown.set_output_formatc C s | j s d Sy t j | } Wn7 t k
r\ } z | j d 7_ WYd d } ~ Xn X| j d | _ x, | j j D] } | j | j | _ q W| j
j | j j } x; | j
j D]* } | j | } | d k r | } q q W| j | } | j ryW | j d | j t | j d } | j d | j } | | | j } Wqt k
r| j j d | j rd } n t d | j YqXn x& | j j D] }
|
j | } qW| j S)
a
Convert markdown to serialized XHTML or HTML.
Keyword arguments:
* source: Source text as a Unicode string.
Markdown processing takes place in five steps:
1. A bunch of "preprocessors" munge the input text.
2. BlockParser() parses the high-level structural elements of the
pre-processed text into an ElementTree.
3. A bunch of "treeprocessors" are run against the ElementTree. One
such treeprocessor runs InlinePatterns against the ElementTree,
detecting inline markup.
4. Some post-processors are run against the text after the ElementTree
has been serialized into text.
5. The output is written to a string.
r) z/. -- Note: Markdown only accepts unicode input!N
z<%s> zz<%s />z4Markdown failed to strip top-level tags. Document=%r)rV r text_typeUnicodeDecodeErrorreasonrQ linesrC valuesrunrD Z
parseDocumentZgetrootrE rm r1 indexdoc_tagr+ rindex
ValueErrorendswithrF ) r8 sourcerc ZpreprootZ
treeprocessorZnewRootoutputstartendppr@ r@ rA convert s8
'
zMarkdown.convertNc C s | p d } | rp t | t j rB t j | d d d | } n t j | | } | j } | j n3 t j j } t | t j
s | j | } n | j d } | j
| } | rBt | t j rt j | d d | d d } | j | | j qt j | } | | d d } | j | nN | j | d } y t j j j | Wn" t k
rt j j | Yn X| S) a? Converts a markdown file and returns the HTML as a unicode string.
Decodes the file using the provided encoding (defaults to utf-8),
passes the file content to markdown, and outputs the html to either
the provided stream or the file with provided name, using the same
encoding as the source file. The 'xmlcharrefreplace' error handler is
used when encoding the output.
**Note:** This is the only place that decoding and encoding of unicode
takes place in Python-Markdown. (All other code is unicode-in /
unicode-out.)
Keyword arguments:
* input: File object or path. Reads from stdin if `None`.
* output: File object or path. Writes to stdout if `None`.
* encoding: Encoding of input and output files. Defaults to utf-8.
zutf-8moderencodingu werrorsxmlcharrefreplace)rG r rH codecsopen getreaderreadclosesysstdinru decodelstripr write getwriterencodestdoutbufferr` ) r8 inputr r Z
input_filetextr Z output_filewriterr@ r@ rA convertFile@ s8
zMarkdown.convertFile)rN rM __qualname____doc__r| r, r r rl Z
ESCAPED_CHARSrB r2 r5 rI rg r7 r6 r r r@ r@ r@ rA r 5 s4
? .
Dc O s t | | } | j | S)a Convert a markdown string to HTML and return HTML as a unicode string.
This is a shortcut function for `Markdown` class to cover the most
basic use case. It initializes an instance of Markdown, loads the
necessary extensions and runs the parser on the given text.
Keyword arguments:
* text: Markdown formatted text as Unicode or ASCII string.
* Any arguments accepted by the Markdown class.
Returns: An HTML document as a string.
)r r )r r9 r: mdr@ r@ rA r s c O s d d d d g } d } xO | D]G } | | | k rF | | | | s( W