Why Gemfury?
Push, build, and install
RubyGems
npm packages
Python packages
Maven artifacts
PHP packages
Go Modules
Debian packages
RPM packages
NuGet packages
hemamaps
Repository URL to install this package:
|
Version:
2.6.6 ▾
|
Markdown
/
__init__.pyc
|
|---|
ó
ÂöWc @@ sH 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
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 d e f d YZ! d Z" d Z# d S( uØ
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 <https://pythonhosted.org/Markdown/> 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).
i ( t absolute_import( t unicode_literalsi ( t versiont version_infoN( t util( t build_preprocessors( t build_block_parser( t build_treeprocessors( t build_inlinepatterns( t build_postprocessors( t Extension( t to_html_stringt to_xhtml_stringu Markdownu markdownu markdownFromFileu MARKDOWNt Markdownc B@ sý e Z d Z d Z i d d 6d d 6e d 6e d 6e 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 Z
d Z d! Z d" Z
d# Z d$ Z d% Z d& Z d( d( d( d' Z RS() u Convert Markdown to HTML.u divu [HTML_REMOVED]u html_replacement_texti u
tab_lengthu enable_attributesu smart_emphasisu lazy_olu htmlu html4u html5u xhtmlu xhtml1u xhtml5u \u `u *u _u {u }u [u ]u (u )u >u #u +u -u .u !c O@ sË d d d d g } xU t | D]G \ } } | | | k rL | | | | <n | d t | k r Pq q Wt | r t j d t n x9 | j j D]( \ } } t | | | j | | q W| j d t | _
| j
rû d | k rû t | _ n d | k rt j d t n d | k r9t j d
t n g | _ d | _
t | _ | j i | _ t j | _ | j d | j d g d
| j d i | j | j d d | j d S( u
Creates a new Markdown instance.
Keyword arguments:
* extensions: A list of extensions.
If they are of type string, the module mdx_name.py will be loaded.
If they are a subclass of markdown.Extension, they will be used
as-is.
* extension_configs: Configuration settings for extensions.
* output_format: Format of output. Supported formats are:
* "xhtml1": Outputs XHTML 1.x. Default.
* "xhtml5": Outputs XHTML style tags of HTML 5
* "xhtml": Outputs latest supported version of XHTML
(currently XHTML 1.1).
* "html4": Outputs HTML 4
* "html5": Outputs HTML style tags of HTML 5
* "html": Outputs latest supported version of HTML
(currently HTML 4).
Note that it is suggested that the more specific formats ("xhtml1"
and "html4") be used as "xhtml" or "html" may change in the future
if it makes sense at that time.
* safe_mode: Deprecated! Disallow raw html. One of "remove", "replace"
or "escape".
* html_replacement_text: Deprecated! Text used when safe_mode is set
to "replace".
* tab_length: Length of tabs in the source. Default: 4
* enable_attributes: Enable the conversion of attributes. Default: True
* smart_emphasis: Treat `_connected_words_` intelligently Default: True
* lazy_ol: Ignore number of first item of ordered lists. Default: True
u
extensionsu extension_configsu safe_modeu
output_formati uL Positional arguments are deprecated in Markdown. Use keyword arguments only.u enable_attributesuÄ "safe_mode" is deprecated in Python-Markdown. Use an HTML sanitizer (like Bleach http://bleach.readthedocs.org/) if you are parsing untrusted markdown text. See the 2.6 release notes for more infou html_replacement_textuI The "html_replacement_text" keyword is deprecated along with "safe_mode".u t
extensionst configsu xhtml1N( t enumeratet lent warningst warnt DeprecationWarningt option_defaultst itemst setattrt gett Falset safeModet enable_attributest registeredExtensionst docTypet Truet stripTopLevelTagst build_parsert
referencesR t HtmlStasht htmlStasht registerExtensionst set_output_formatt reset( t selft argst kwargst post ct argt optiont default( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyt __init__Q s< #
c C@ sO t | | _ t | | _ t | | _ t | | _ t | | _ | S( u* Build the parser from the various parts. (
R t
preprocessorsR t parserR t inlinePatternsR t treeprocessorsR t postprocessors( R' ( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyR £ s c C@ sÁ xº | D]² } t | t j r@ | j | | j | i } n t | t r | j | t t j d | j
j | j
j f q | d k r t d | j
j | j
j f q q W| S( u*
Register extensions with this instance of Markdown.
Keyword arguments:
* extensions: A list of extensions, which can either
be strings or objects. See the docstring on Markdown.
* configs: A dictionary mapping module names to config options.
u& Successfully loaded extension "%s.%s".u7 Extension "%s.%s" must be of type: "markdown.Extension"N( t
isinstanceR t string_typet build_extensionR R
t extendMarkdownt globalst loggert debugt __class__t
__module__t __name__t Nonet TypeError( R' R R t ext( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyR$ ¬ s
! #c C@ sÕ t | } | j d } | d k r¸ | | d d !} | | } g | j d D] } | j d ^ qR } | j g | D]$ \ } } | j | j f ^ qz t j d t n d | k rÖ | j d d n | d f \ } } y^ t j | } t
j d
| d | k rEt | d p8| o8t | | rEt
n Wnt
k
rYd j d
| g }
y> t j |
} t
j d
|
t j d |
| f t WqZt
k
rUd j d | g } y> t j | } t
j d
| t j d | | f t WqVt
k
rQ} d | | |
| f }
|
f | j d | _ qVXqZXn X| rst | | | Sy | j | SWnJ t k
rÐ} | j d }
d | |
f }
|
f | j d | _ n Xd S( uÆ Build extension by name, then return the module.
The extension name may contain arguments as part of the string in the
following format: "extname(key1=value1,key2=value2)"
u (i i iÿÿÿÿu ,u =u1 Setting configs in the Named Extension string is deprecated. It is recommended that you pass an instance of the extension class to Markdown or use the "extension_configs" keyword. The current behavior will raise an error in version 2.7. See the Release Notes for Python-Markdown version 2.6 for more info.u :u u+ Successfuly imported extension module "%s".u .u
makeExtensionu markdown.extensionsu Using short names for Markdown's builtin extensions is deprecated. Use the full path to the extension with Python's dot notation (eg: "%s" instead of "%s"). The current behavior will raise an error in version 2.7. See the Release Notes for Python-Markdown version 2.6 for more info.u _u mdxu$ Markdown's behavior of prepending "mdx_" to an extension name is deprecated. Use the full path to the extension with Python's dot notation (eg: "%s" instead of "%s"). The current behavior will raise an error in version 2.7. See the Release Notes for Python-Markdown version 2.6 for more info.u5 Failed loading extension '%s' from '%s', '%s' or '%s'u% Failed to initiate extension '%s': %sN( t dictt findt splitt updatet stripR R R t importlibt
import_moduleR: R; t hasattrt ImportErrort joinR( t getattrt
makeExtensiont AttributeError( R' t ext_nameR R* t ext_argst xt pairst yt
class_namet modulet module_namet module_name_old_stylet et message( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyR7 Ç sj
+8
0
c C@ s | j j | | S( u# This gets called by the extension ( R t append( R' t extension( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyt registerExtension+ s c C@ sN | j j | j j x- | j D]" } t | d r$ | j q$ q$ W| S( uR
Resets all state variables so that we can start with a new text.
u reset( R# R& R! t clearR RI ( R' R[ ( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyR& 0 s
c C@ s | j | _ y | j | j | _ Wnp t k
r } t | j j } | j d | j d d j | d f } | f | j d | _ n X| S( u/ Set the output format for the class instance. u+ Invalid Output Format: "%s". Use one of %s.u "u ", "i (
t lowert
output_formatt output_formatst
serializert KeyErrort listt keyst sortRK R( ( R' t formatRX t
valid_formatsRY ( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyR% = s
c C@ sÖ | j s d Sy t j | } Wn% t k
rJ } | j d 7_ n X| j d | _ x, | j j D] } | j | j | _ qm W| j
j | j j } x; | j
j D]* } | j | } | d k r· | } q· q· W| j | } | j r£yT | j d | j t | j d } | j d | j } | | | !j } Wq£t k
r| j j d | j rd } q t d | j q£Xn x& | j j D] }
|
j | } q³W| j S(
uä
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.
u u/ . -- Note: Markdown only accepts unicode input!u
u <%s>i u </%s>u <%s />u4 Markdown failed to strip top-level tags. Document=%rN( RF R t text_typet UnicodeDecodeErrort reasonRD t linesR0 t valuest runR1 t
parseDocumentt getrootR3 R? Ra R t indext doc_tagR t rindext
ValueErrort endswithR4 ( R' t sourceRX t prept roott
treeprocessort newRoott outputt startt endt pp( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyt convertL s:
'
c 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 | nM | j | d } y t j j j | Wn! t k
rt j j | n X| S( u? 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.
u utf-8t modeu rt encodingu u wt errorsu xmlcharrefreplace( R5 R R6 t codecst opent getreadert readt closet syst stdinRh t decodet lstripR~ t writet getwritert encodet stdoutt bufferRN ( R' t inputRz R t
input_filet textt htmlt output_filet writer( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyt convertFile s8
N( R> R= t __doc__Rq R R R R R` t
ESCAPED_CHARSR/ R R$ R7 R\ R& R% R~ R? R ( ( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyR
8 s4
R d
Fc O@ s t | | } | j | S( uÔ 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 R( R) t md( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyt markdownÞ s c O@ sÐ d d d d g } d } xO | D]G } | | | k rF | | | | <n | d 7} | t | k r Pq q Wt | r t j d t n t | } | j | j d d | j d d | j d d d S( u¤ Read markdown code from a file and write it to a file or a stream.
This is a shortcut function which initializes an instance of Markdown,
and calls the convertFile method rather than convert.
Keyword arguments:
* input: a file name or readable object.
* output: a file name or writable object.
* encoding: Encoding of input and output.
* Any arguments accepted by the Markdown class.
u inputu outputu
extensionsu encodingi i us Positional arguments are depreacted in Markdown and will raise an error in version 2.7. Use keyword arguments only.N( R R R R R
R R R? ( R( R) R* R+ R, R ( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyt markdownFromFileñ s
($ R t
__future__R R t __version__R R R R t loggingR RG t R R0 R t blockprocessorsR R3 R t inlinepatternsR R4 R R R
t serializersR R t __all__t getLoggerR: t objectR
R R ( ( ( s/ build/lib.linux-x86_64-2.7/markdown/__init__.pyt <module> s, ÿ §