ó
Šç\c @@ sþ d 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 l Z d d l Z d d l
Z
e j d
ƒ Z e j d ƒ Z d „ Z d
„ Z d „ Z d „ Z d e f d „ ƒ YZ d e f d „ ƒ YZ d d „ Z d S( uŽ
HeaderID Extension for Python-Markdown
======================================
Auto-generate id attributes for HTML headers.
Basic usage:
>>> import markdown
>>> text = "# Some Header #"
>>> md = markdown.markdown(text, ['headerid'])
>>> print md
All header IDs are unique:
>>> text = '''
... #Header
... #Header
... #Header'''
>>> md = markdown.markdown(text, ['headerid'])
>>> print md
To fit within a html template's hierarchy, set the header base level:
>>> text = '''
... #Some Header
... ## Next Level'''
>>> md = markdown.markdown(text, ['headerid(level=3)'])
>>> print md
Next Level
Works with inline markup.
>>> text = '#Some *Header* with [markup](http://example.com).'
>>> md = markdown.markdown(text, ['headerid'])
>>> print md
Turn off auto generated IDs:
>>> text = '''
... # Some Header
... # Another Header'''
>>> md = markdown.markdown(text, ['headerid(forceid=False)'])
>>> print md
Some Header
Another Header
Use with MetaData extension:
>>> text = '''header_level: 2
... header_forceid: Off
...
... # A Header'''
>>> md = markdown.markdown(text, ['headerid', 'meta'])
>>> print md
A Header
Copyright 2007-2011 [Waylan Limberg](http://achinghead.com/).
Project website:
Contact: markdown@freewisdom.org
License: BSD (see ../docs/LICENSE for details)
Dependencies:
* [Python 2.3+](http://python.org)
* [Markdown 2.0+](http://packages.python.org/Markdown/)
i ( t absolute_import( t unicode_literalsi ( t Extensioni ( t
Treeprocessor( t HTML_PLACEHOLDER_REt parseBoolValueNu MARKDOWNu ^(.*)_([0-9]+)$c C@ s_ t j d | ƒ j d d ƒ } t j d d | j d ƒ ƒ j ƒ j ƒ } t j d | | | ƒ S( u, Slugify a string, to make it URL friendly. u NFKDu asciiu ignoreu [^\w\s-]u u [%s\s]+( t unicodedatat normalizet encodet ret subt decodet stript lower( t valuet separator( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt slugify[ s *c C@ s xk | | k s | rm t j | ƒ } | rZ d | j d ƒ t | j d ƒ ƒ d f } q d | d f } q W| j | ƒ | S( u@ Ensure id is unique in set of ids. Append '_1', '_2'... if not u %s_%di i ( t
IDCOUNT_REt matcht groupt intt add( t idt idst m( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt uniqueb s /
c c@ sY | j r | j Vn x> | D]6 } x t | ƒ D] } | Vq. W| j r | j Vq q Wd S( uˆ Loop through all children and return text only.
Reimplements method of same name added to ElementTree in Python 2.7
N( t textt itertextt tail( t elemt et s( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyR n s
c @ s ‡ f d † } t j | | ƒ S( uC Extract raw HTML, reduce to plain text and swap with placeholder. c @ st y) ˆ j j t | j d ƒ ƒ \ } } Wn! t t f k
rL | j d ƒ SXˆ j ra | ra d St j d d | ƒ S( u& Substitute raw html with plain text. i i u u (<[^>]+>)|(&[\#a-zA-Z0-9]+;)( t htmlStasht
rawHtmlBlocksR R t
IndexErrort TypeErrort safeModeR R
( R t rawt safe( t md( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt _html_sub s )( R R
( R R' R( ( ( R' s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt stashedHTML2text} s t HeaderIdTreeprocessorc B@ s) e Z d Z e ƒ Z d „ Z d „ Z RS( u Assign IDs to headers. c C@ s | j ƒ \ } } | j d } | j d } xÞ | j ƒ D]Ð } | j d k r9 | rÄ d | j k ru | j d ƒ } n0 t d
j t | ƒ ƒ | j ƒ } | | | ƒ } | j
d t | | j ƒ ƒ n | r t
| j d ƒ | } | d k rö d } n d
| | _ q q9 q9 Wd S( Nu slugifyu separatoru h1u h2u h3u h4u h5u h6u idu iÿÿÿÿi u h%d( u h1u h2u h3u h4u h5u h6( t _get_metat configt getiteratort tagt attribt getR) t joinR R' t setR t IDsR ( t selft doct start_levelt force_idR t sepR R t level( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt run’ s
! c C@ s« t | j d ƒ d } t | j d ƒ } t | j d ƒ r¡ d | j j k ro t | j j d d ƒ d } n d | j j k r¡ t | j j d d ƒ } q¡ n | | f S( u2 Return meta data suported by this ext as a tuple u leveli u forceidu Metau header_leveli u header_forceid( R R, R t hasattrR' t Meta( R4 R9 t force( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyR+ ¦ s ! ( t __name__t
__module__t __doc__R2 R3 R: R+ ( ( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyR* s t HeaderIdExtensionc B@ s# e Z d „ Z d „ Z d „ Z RS( c C@ sh i d d g d 6d d g d 6d d g d 6t d
g d 6| _ x$ | D] \ } } | j | | ƒ qD Wd S( Nu 1u Base level for headers.u levelu Trueu Force all headers to have an id.u forceidu -u Word separator.u separatoru Callable to generate anchorsu slugify( R R, t setConfig( R4 t configst keyR ( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt __init__³ s
c C@ s… | j | ƒ t ƒ | _ | | j _ | j ƒ | j _ d | j j ƒ k rh | j j d | j d ƒ n | j j d | j d ƒ d S( Nu attr_listu headeridu
>attr_listu >prettify( t registerExtensionR* t processorR' t
getConfigsR, t treeprocessorst keysR ( R4 R' t
md_globals( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt extendMarkdown¿ s
c C@ s t ƒ | j _ d S( N( R2 RG R3 ( R4 ( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt resetË s ( R> R? RE RL RM ( ( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyRA ² s c C@ s
t d | ƒ S( NRC ( RA ( RC ( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt
makeExtensionÏ s ( R@ t
__future__R R t R RI R t utilR R R t loggingR t getLoggert loggert compileR R R R R) R* RA t NoneRN ( ( ( s@ /usr/lib/python2.7/site-packages/markdown/extensions/headerid.pyt K s" %