Ñò
éíÑXc @ sÓ d Z d d k Z d d k l Z d d k Z d d k l Z l Z l Z e e d Z e i d ƒ Z
d e i i f d „ ƒ YZ
d e i f d
„ ƒ YZ d d „ Z e d j o d d k Z e i ƒ n d S(
s¶
HeaderID Extension for Python-Markdown
======================================
Adds ability to set HTML IDs for headers.
Basic usage:
>>> import markdown
>>> text = "# Some Header # {#some_id}"
>>> md = markdown.markdown(text, ['headerid'])
>>> md
u'Some Header
'
All header IDs are unique:
>>> text = '''
... #Header
... #Another Header {#header}
... #Third Header {#header}'''
>>> md = markdown.markdown(text, ['headerid'])
>>> md
u'\n\n'
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)'])
>>> md
u'\nNext Level
'
Turn off auto generated IDs:
>>> text = '''
... # Some Header
... # Header with ID # { #foo }'''
>>> md = markdown.markdown(text, ['headerid(forceid=False)'])
>>> md
u'Some Header
\nHeader with ID
'
Use with MetaData extension:
>>> text = '''header_level: 2
... header_forceid: Off
...
... # A Header'''
>>> md = markdown.markdown(text, ['headerid', 'meta'])
>>> md
u'A Header
'
Copyright 2007-2008 [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://www.freewisdom.org/projects/python-markdown/)
iÿÿÿÿN( t etree( t ascii_lowercaset digitst punctuations -_s ^(.*)_([0-9]+)$t HeaderIdProcessorc B sb e Z d Z e i d e i ƒ Z g Z d „ Z d „ Z d „ Z
e d „ Z d „ Z
d „ Z RS( s, Replacement BlockProcessor for Header IDs. s˜ (^|\n)
(?P\#{1,6}) # group('level') = string of hashes
(?P.*?) # group('header') = Header text
\#* # optional closing hashes
(?:[ \t]*\{[ \t]*\#(?P[-_:a-zA-Z0-9]+)[ \t]*\})?
(\n|$) # ^^ group('id') = id attribute
c C s t | i i | ƒ ƒ S( N( t boolt REt search( t selft parentt block( ( s@ /usr/lib/python2.6/site-packages/markdown/extensions/headerid.pyt test[ s c C su | i d ƒ } | i i | ƒ } | o<| | i ƒ } | | i ƒ } | o | i i | | g ƒ n | i ƒ \ } } t | i d ƒ ƒ | } | d j o
d } n t
i i | d | ƒ }
| i d ƒ i
ƒ |
_ | i d ƒ o& |
i d | i | i d ƒ ƒ ƒ n4 | o, |
i d | i | i d ƒ i
ƒ ƒ ƒ n | o | i d | ƒ qqn t t d ƒ d S( Ni t leveli s h%dt headert ids We've got a problem header!( t popR R t startt endt parsert parseBlockst _get_metat lent groupt markdownR t
SubElementt stript textt sett
_unique_idt
_create_idt insertt messaget CRITICAL( R R t blocksR
t mt beforet aftert start_levelt force_idR t h( ( s@ /usr/lib/python2.6/site-packages/markdown/extensions/headerid.pyt run^ s(
&,c C sÅ t | i d d ƒ d } | i | i d d ƒ } t | i d ƒ os | i i i d ƒ o" t | i i d d ƒ d } n | i i i d ƒ o! | i | i i d d ƒ } q» n | | f S( s2 Return meta data suported by this ext as a tuple R i i t forceidt Metat header_levelt header_forceid( t intt configt _str2boolt hasattrt mdR* t has_key( R R t force( ( s@ /usr/lib/python2.6/site-packages/markdown/extensions/headerid.pyR { s "%c C s@ t | ƒ } | i ƒ d
j o t S| i ƒ d j o t S| S( s& Convert a string to a booleen value. t 0t ft falset offt not nt 1t tt truet ont yest y( R4 R5 R6 R7 R8 R9 ( R: R; R< R= R> R? ( t strt lowert Falset True( R t st default( ( s@ /usr/lib/python2.6/site-packages/markdown/extensions/headerid.pyR/ † s c C s‚ xk | | i j oZ t i | ƒ } | o0 d | i d ƒ t | i d ƒ ƒ d f } q d | d f } q W| i i | ƒ | S( s2 Ensure ID is unique. Append '_1', '_2'... if not s %s_%di i ( t IDst
IDCOUNT_REt matchR R- t append( R R R" ( ( s@ /usr/lib/python2.6/site-packages/markdown/extensions/headerid.pyR s 0c C sl d } xV | i ƒ i d d ƒ D]< } | t j o | | 7} q | t j o | d 7} q q W| i | ƒ S( s Return ID from Header text. t t t _t +( RA t replacet ID_CHARSR R ( R R
R' t c( ( s@ /usr/lib/python2.6/site-packages/markdown/extensions/headerid.pyR š s
( t __name__t
__module__t __doc__t ret compilet VERBOSER RF R R( R RB R/ R R ( ( ( s@ /usr/lib/python2.6/site-packages/markdown/extensions/headerid.pyR L s t HeaderIdExtensionc B s# e Z d „ Z d „ Z d „ Z RS( c C sN h d d g d 6d d g d 6| _ x$ | D] \ } } | i | | ƒ q* Wd S( NR: s Base level for headers.R RC s Force all headers to have an id.R) ( R. t setConfig( R t configst keyt value( ( s@ /usr/lib/python2.6/site-packages/markdown/extensions/headerid.pyt __init__¦ s
c C sQ | i | ƒ t | i ƒ | _ | | i _ | i | i _ | i | i i d A s Y