3
\ @ sx d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd l
Z
G d
d d eZ G d d
d
eZ i fddZ
d S )a
Admonition extension for Python-Markdown
========================================
Adds rST-style admonitions. Inspired by [rST][] feature with the same name.
The syntax is (followed by an indented block with the contents):
!!! [type] [optional explicit title]
Where `type` is used as a CSS class name of the div. If not present, `title`
defaults to the capitalized `type`, so "note" -> "Note".
rST suggests the following `types`, but you're free to use whatever you want:
attention, caution, danger, error, hint, important, note, tip, warning
A simple example:
!!! note
This is the first line inside the box.
Outputs:
Note
This is the first line inside the box
You can also specify the title and CSS class of the admonition:
!!! custom "Did you know?"
Another line here.
Outputs:
Did you know?
Another line here.
[rST]: http://docutils.sourceforge.net/docs/ref/rst/directives.html#specific-admonitions
By [Tiago Serafim](http://www.tiagoserafim.com/).
)absolute_import)unicode_literals ) Extension )BlockProcessor)etreeNc @ s e Zd ZdZdd ZdS )AdmonitionExtensionz+ Admonition extension for Python-Markdown. c C s& |j | |jjjdt|jd dS )z& Add Admonition to Markdown instance.
admonition_beginN)registerExtensionparserblockprocessorsaddAdmonitionProcessor)selfmd
md_globals r +build/lib/markdown/extensions/admonition.pyextendMarkdown6 s
z"AdmonitionExtension.extendMarkdownN)__name__
__module__ __qualname____doc__r r r r r r 3 s r c @ s6 e Zd ZdZdZejdZdd Zdd Z dd Z
d
S ) r r
zadmonition-titlez%(?:^|\n)!!!\ ?([\w\-]+)(?:\ "(.*?)")?c C sB | j |}| jj|p@|jd| j o@|o@|jddj| jdkS )N class r ) lastChildREsearch
startswith
tab_lengthgetfind CLASSNAME)r parentblocksiblingr r r testE s
zAdmonitionProcessor.testc C s | j |}|jd}| jj|}|r8||j d d }| j|\}}|r| j|\}}tj|d} | j dd| j
|f |rtj| d}
||
_ |
j d| j n|} | j
j| | |r|jd| d S )Nr r divr z%s %sp)r popr r! enddetabget_class_and_titler
SubElementsetr& textCLASSNAME_TITLEr
parseChunkinsert) r r' blocksr) r( mtheRestklasstitler+ r, r r r runK s$
zAdmonitionProcessor.runc C s@ |j dj |j d }}|d kr,|j }n |dkr8d }||fS )Nr r r )grouplower
capitalize)r matchr: r; r r r r0 h s
z'AdmonitionProcessor.get_class_and_titleN) r r r r& r4 recompiler r* r< r0 r r r r r ? s
r c C s
t | dS )N)configs)r )rC r r r
makeExtensionu s rD )r
__future__r r r r r r utilr rA r r rD r r r r ) s 6