...
2 - 2004/03/26 - RAFA - rewritten from (almost) scratch to include all features from Textile 2 and a little bit more. 2.0.1 - 2004/04/02 - RAFA - Fixed validating function that uses uTidyLib. 2.0.2 - 2004/04/02 - RAFA - Fixed problem with caps letters in URLs. 2.0.3 - 2004/04/19 - RAFA - Multiple classes are allowed, thanks to Dave Anderson. The "lang" attribute is now removed from, to be valid
XHTML. Fixed UCAS problem.
2.0.4 - 2004/05/20 - RAFA, CLB - Added inline formatting to table cells.
Curt Bergmann fixed a bug with the colspan formatting. Added Amazon
Associated id.
2.0.5 - 2004/06/01 - CL - Applied patch from Chris Lawrence to (1) fix
that Amazon associates ID was being added to all search URIs, (2)
customize the Amazon site used with the AMAZON variable, and (3) added
an "isbn" URI type that links directly to an Amazon product by ISBN or
Amazon ASIN.
2.0.6 - 2004/06/02 - RAFA - Fixed CAPS problem, again. I hope this is
the last time.
2.0.7 - 2004/06/04 - RAFA, MW - Fixed bullet macro, thanks to Adam
Messinger. Added patch from Michal Wallace changing {}.pop() for
compatibility with Python 2.2.x.
2.0.8 - 2004/06/25 - RAFA - Strip tags when adding the content from a
footnote to the reference link. Escaped '<' and '>' in the self-
generated documentation.
2.0.9 - 2004/10/04 - RAFA - In images, if ALT is not defined, add an
empty attribute. Added "LaTeX" style open/close quotes. Fixed a bug
where the acronym definition was being formatted with inline rules.
Handle "broken" lines correctly, removing the
from inside
split HTML tags.
2.0.10 - 2004/10/06 - RAFA, LO - Escape all non-escaped ampersands.
Applied "trivial patch" from Ludvig Omholt to remove newline right
after the tag.
s latin-1t asciii s www.amazon.comiNc C s | i d | oH | i d | d d } | i d o | i d d d } q\ n | i d | o | i d | d d } n | i i d d } | S( s Extracts text from inside a tag.
This function extracts the text from inside a given tag.
It's useful to get the text between or
when using the validators or the colorizer.
s <%si t >s
s%
( t preg_replaceR t htmlizert filterR t getvalueR ( t codet code_int code_out( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt _color s ( t Tidyc C s: t i | d d d d d d \ } } } } t | d S( s] mxTidy's XHTML validator.
This function is a wrapper to mxTidy's validator.
t output_xhtmli t numeric_entitiest wrapi t body( R t tidyR ( R t nerrorst nwarningst errortext( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt _tidy1 s -c
C s: t i | d d d d d d d d } t t | d S( si uTidyLib's XHTML validator.
This function is a wrapper to uTidyLib's validator.
R i t add_xml_decli t indentt tidy_markR ( R t parseStringR t str( R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt _tidy2 s 'i c C s" t | j o t i | IJn d S( s Outputs debug information to sys.stderr.
This function outputs debug information if DEBUGLEVEL is
higher than a given treshold.
N( t
DEBUGLEVELt syst stderr( t st level( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt _debug s
s (?:(?:<>|[<>=]) # Either '<>', '<', '>' or '='
(?![^\s]*(?:<>|[<>=]))) # Look-ahead to ensure it happens once
t alignsP (?:[\(\)]+) # Any number of '(' and/or ')'
t paddings ( #
(?:\(\#[\w]+\)) # (#id)
| #
(?:\((?:[\w]+(?:\s[\w]+)*) #
(?:\#[\w]+)?\)) # (class1 class2 ... classn#id) or (class1 class2 ... classn)
) #
(?![^\s]*(?:\([\w#]+\))) # must happen once
t classids (?:\[[\w-]+\]) # [lang]
(?![^\s]*(?:\[.*?\])) # must happen once
t langs (?:{[^\}]+}) # {style}
(?![^\s]*(?:{.*?})) # must happen once
t styles/ [\!"#\$%&'()\*\+,\-\./:;<=>\?@\[\\\]\^_`{\|}\~]t punctsp (?=[a-zA-Z0-9./#]) # Must start correctly
(?: # Match the leading part (proto://hostname, or just hostname)
(?:ftp|https?|telnet|nntp) # protocol
:// # ://
(?: # Optional 'username:password@'
\w+ # username
(?::\w+)? # optional :password
@ # @
)? #
[-\w]+(?:\.\w[-\w]*)+ # hostname (sub.example.com)
| #
(?:mailto:)? # Optional mailto:
[-\+\w]+ # username
\@ # at
[-\w]+(?:\.\w[-\w]*)+ # hostname
| #
(?:[a-z0-9](?:[-a-z0-9]*[a-z0-9])?\.)+ # domain without protocol
(?:com\b # TLD
| edu\b #
| biz\b #
| gov\b #
| in(?:t|fo)\b # .int or .info
| mil\b #
| net\b #
| org\b #
| museum\b #
| aero\b #
| coop\b #
| name\b #
| pro\b #
| [a-z][a-z]\b # two-letter country codes
) #
)? #
(?::\d+)? # Optional port number
(?: # Rest of the URL, optional
/? # Start with '/'
[^.!,?;:"'<>()\[\]{}\s\x7F-\xFF]* # Can't start with these
(?: #
[.!,?;:]+ # One or more of these
[^.!,?;:"'<>()\[\]{}\s\x7F-\xFF]+ # Can't finish with these
#'" # # or ' or "
)* #
)? #
t urls$ (?P #
(?: %(align)s # alignment
| %(classid)s # class and/or id
| %(padding)s # padding tags
| %(lang)s # [lang]
| %(style)s # {style}
)+ #
)? #
t battrsM (?P #
(?: %(align)s # alignment
| ((?:\(\#[\w]+\)) # (#id)
| #
(?:\((?:[\w]+(?:\s[\w]+)*) #
(?:\#[\w]+)?\)) # (class1 class2 ... classn#id) or (class1 class2 ... classn)
) #
| %(padding)s # padding tags
| %(lang)s # [lang]
| %(style)s # {style}
)+ #
)? #
t olattrs# (?P #
(?: %(align)s # alignment
| %(classid)s # class and/or id
| %(padding)s # padding tags
| %(lang)s # [lang]
| %(style)s # {style}
)+ #
)? #
t liattrs (?P #
(?: %(classid)s # class and/or id
| %(lang)s # [lang]
| %(style)s # {style}
)+ #
)? #
t qattrs (?P # Links attributes
(?: %(align)s # alignment
| %(classid)s # class and/or id
| %(lang)s # [lang]
| %(style)s # {style}
)+ #
)? #
t lattrsk (?P #
(?: #
(?: [<>]+ # horizontal alignment tags
(?![^\s]*(?:[<>]))) # (must happen once)
| #
(?: [\-\^~]+ # vertical alignment tags
(?![^\s]*(?:[\-\^~]))) # (must happen once)
| %(classid)s # class and/or id
| %(padding)s # padding tags
| %(style)s # {style}
)+ #
)? #
t iattrsT (?: #
(?:([\d]+%?)x([\d]+%?)) # 20x10
| #
(?: # or
(?:([\d]+)%?w\s([\d]+)%?h) # 10h 20w
| # or
(?:([\d]+)%?h\s([\d]+)%?w) # 20w 10h
) #
)? #
t resizes (?P #
(?: #
(?: [\^~] # vertical alignment
(?![^\s]*(?:[\^~]))) # (must happen once)
| %(align)s # alignment
| %(lang)s # [lang]
| %(style)s # {style}
| %(classid)s # class and/or id
| %(padding)s # padding
| _ # is this a header row/cell?
| \\\d+ # colspan
| /\d+ # rowspan
)+ #
)? #
t tattrc s8 f d } t i | } t | | i | | S( s Alternative re.sub that handles empty groups.
This acts like re.sub, except it replaces empty groups with ''
instead of raising an exception.
c sh d } } t | i xE | i D]7 } | p
d } n | i d | | } | d 7} q) W| S( Ni t s \%s( R( t groupsR ( t matchobjt countert rct matchitem( t replacement( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt replacement_func s
( t ret compileR( t sub( t patternR> R R? t p( ( R> s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyR s
c C s t i d | p t | | | Sg } xP t i d | D]< } t i d | p t | | | } n | i | q= Wd i | Sd S( sT Replacement outside HTML tags.
Does a preg_replace only outside HTML tags.
s <.*>s (<.*?>)s <.*?>R8 N( R@ t searchR R t matcht appendt join( RC R> R t linest line( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt html_replace s t _BaseHTMLProcessorc
B s e Z 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 Z d Z d Z
d Z RS( t areat baset basefontt brt colt framet hrt imgt inputt isindext linkt metat paramc C s t i i | d S( N( t sgmllibt
SGMLParsert __init__( t self( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyR\ s c C s g | _ t i i | d S( N( t piecesRZ R[ t reset( R] ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyR_ s c C s g } | D]7 \ } } | | i t i i d | i f q ~ } g } | D]3 \ } } | | | d j o
| i p | f qV ~ } | S( Nc S s t t | i d S( i ( t unichrt intR9 ( t m( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt s t relt type( Rd s type( t lowerRZ t charrefRB R ( R] t attrst _[1]t kt vt _[2]( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt normalize_attrs s KGc C s d i g } | D] \ } } | d | | f q ~ } | | i j o | i i d t n | i i d t d S( NR8 s %s="%s"s <%(tag)s%(strattrs)s />s <%(tag)s%(strattrs)s>( RH t elements_no_end_tagR^ RG t locals( R] R Rh Ri t keyt valuet strattrs( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt unknown_starttag s :c C s/ | | i j o | i i d t n d S( Ns
( Rn R^ RG Ro ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt unknown_endtag s c C s | i i d t d S( Ns
&#%(ref)s;( R^ RG Ro ( R] t ref( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt handle_charref s c C s | i i d t d S( Ns &%(ref)s;( R^ RG Ro ( R] Ru ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt handle_entityref s c C s | i i | d S( N( R^ RG ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt handle_data% s c C s | i i d t d S( Ns ( R^ RG Ro ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt handle_comment+ s c C s | i i d t d S( Ns ( R^ RG Ro ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt handle_pi0 s c C s | i i d t d S( Ns ( R^ RG Ro ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt handle_decl5 s c C s d i | i S( s( Return processed HTML as a single stringR8 ( RH R^ ( R] ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt output< s ( t __name__t
__module__Rn R\ R_ Rm Rs Rt Rv Rw Rx Ry Rz R{ R| ( ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyRL s
t _HTMLSanitizerc G B s8 e Z d d d d d d d d d d d
d d d
d d d d d d d d d d d d d d d d d d d d! d" d# d$ d% d& d' d( d) d* d+ d, d- d. d/ d0 d1 d2 d3 d4 d5 d6 d7 d8 d9 d: d; d< d= d> d? d@ dA dB dC dD dE dF gG Z d dG dH dI dJ dK dL dM dN dO dP dQ dR dS dT d dU dV dW dX dY dZ d[ d\ d d] d^ d_ d` da db dc dd de df dg d' dh di dj dk dl dm dn do dp dq dr ds dt du dv dw dx dy dz d{ d| d6 d} d~ d d d d d d d d d d gG Z d d g Z d d d d d d g Z d d g Z e e Z e e Z d Z d Z d Z d Z
d Z d Z RS( t at abbrt acronymt addressRM t bt bigt
blockquoteRP t buttont captiont centert citeR RQ t colgroupt ddt delt dfnt dirt divt dlt dtt emt fieldsett fontt formt h1t h2t h3t h4t h5t h6RS t iRT RU t inst kbdt labelt legendt lit mapt menut olt optgroupt optionRD R
t qR& t sampt selectt smallt spant striket strongRB t supt tablet tbodyt tdt textareat tfoott tht theadt trt ttt ut ult vart accepts accept-charsett accesskeyt actionR) t altt axist bordert cellpaddingt cellspacingt chart charofft charsett checkedt classt cleart colst colspant colort compactt coordst datetimet disabledt enctypet forRR t headerst heightt hreft hreflangt hspacet idt ismapR, t longdesct maxlengtht mediat methodt multiplet namet nohreft noshadet nowrapt promptt readonlyRd t revt rowst rowspant rulest scopet selectedt shapet sizet srct startt summaryt tabindext targett titleRe t usemapt valignRq t vspacet widtht scriptt applett matht mit mnt mot mrowt msupt modet xmlnsc C s t i | d | _ d S( Ni ( RL R_ t unacceptablestack( R] ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyR_ _ s
c C s | | i j o( | | i j o | i d 7_ n d S| i | } g } | D]- \ } } | | i j o | | | f qR qR ~ } t i | | | d S( Ni ( t acceptable_elementst" unacceptable_elements_with_end_tagR Rm t acceptable_attributesRL Rs ( R] R Rh Ri Rp Rq ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyRs c s Ac C sL | | i j o( | | i j o | i d 8_ n d St i | | d S( Ni ( R R R RL Rt ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyRt l s
c C s d S( N( ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyRz s s c C s d S( N( ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyR{ v s c C s" | i p t i | | n d S( N( R RL Rx ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyRx y s
(
R} R~ R R R t mathml_elementst mathml_attributesR_ Rs Rt Rz R{ Rx ( ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyR A s: $
t Textilerc B s e Z d Z d d Z d Z d Z e e e e e
d Z d Z d Z
d% d d Z h d
d Z d% d% d% d Z d% d% d
Z d% d% d Z d% d% d Z d% d% d% d Z d% d d% d Z d% d d% d Z d Z d% d% d% d Z d% d% d% d Z d% d% d Z d Z d Z d% d Z d Z d Z d Z! d Z" d Z# d Z$ d! Z% d" Z& d# Z' d$ Z( RS(& sU Textile formatter.
This is the base class for the PyTextile text processor.
R8 c C s | | _ t | _ h | _ d | i d \.) # .
(?P\.)? # Extended paragraph denoted by a second dot
\s # whitespace
(?P.*) # text
s ^pre # Pre signature
%(battr)s # Pre attributes
(?P\.) # .
(?P\.)? # Extended pre denoted by a second dot
\s # whitespace
(?P.*) # text
s ^bc # Blockcode signature
%(battr)s # Blockcode attributes
(?P\.) # .
(?P\.)? # Extended blockcode denoted by a second dot
\s # whitespace
(?P.*) # text
sc ^bq # Blockquote signature
%(battr)s # Blockquote attributes
(?P\.) # .
(?P\.)? # Extended blockquote denoted by a second dot
(:(?P # Optional cite attribute
( #
%(url)s # URL
| "[\w]+(?:\s[\w]+)*" # "Name inside quotes"
)) #
)? #
\s # whitespace
(?P.*) # text
s ^h # Header signature
(?P\d) # Header number
%(battr)s # Header attributes
(?P\.) # .
(?P\.)? # Extended header denoted by a second dot
\s # whitespace
(?P.*) # text
s ^fn # Footnote signature
(?P[\d]+) # Footnote number
(?P\.) # .
(?P\.)? # Extended footnote denoted by a second dot
\s # whitespace
(?P.*) # text
s ^dl # Definition list signature
%(battr)s # Definition list attributes
(?P\.) # .
(?P\.)? # Extended definition list denoted by a second dot
\s # whitespace
(?P.*) # text
s ^%(olattr)s # Ordered list attributes
\# # Ordered list signature
%(liattr)s # List item attributes
(?P\.)? # .
\s # whitespace
(?P.*) # text
s ^%(olattr)s # Unrdered list attributes
\* # Unordered list signature
%(liattr)s # Unordered list attributes
(?P\.)? # .
\s # whitespace
(?P.*) # text
sE ^==?(?P.*?)(==)?$ # Escaped text
sB ^(?P<.*)$ # XHTML tag
s: ^(?P # itex code
\\\[ # starts with \[
.*? # complicated mathematical equations go here
\\\]) # ends with \]
s ^table # Table signature
%(tattr)s # Table attributes
(?P\.) # .
(?P\.)? # Extended blockcode denoted by a second dot
\s # whitespace
(?P.*) # text
so ^(?P
\|
.*)
s& ^(?Ptell\sme\sabout\stextile\.)$N( R t rest searchest amazon_associate_idRH t AMAZONt paragraphR
t bcR t headert footnoteR R R t escapet itexR t aboutt
signatures( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyR\ s4
"&
c C s[ | i i | _ | i i d d | _ | i i d d | _ | i | i | _ d S( sV Pre-processing of the text.
Remove whitespace, fix carriage returns.
s
s
s
N( R R R t sanitize( R] ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyt
preprocess s c C sk h } t i d | i t i } x* | i | i D] \ } } | | |
and
.
---
h1. Sanitizing
Textile can help you generate valid XHTML(eXtensible HyperText Markup Language).
It will fix any single tags that are not properly closed, like
@![]()
@, @
@ and @
@.
If you have "mx.Tidy":http://www.egenix.com/files/python/mxTidy.html
and/or "µTidyLib":http://utidylib.sourceforge.net/ installed,
it also can optionally validade the generated code with these wrappers
to ensure 100% valid XHTML(eXtensible HyperText Markup Language).
s <(img|br|hr)(.*?)(?:\s*/?\s*)?>s <\1\2 />s% &(?!#?[xX]?(?:[0-9a-fA-F]+|\w{1,8});)s &( R ( R] R ( ( s6 /usr/lib/python2.6/site-packages/webhelpers/textile.pyR f s c C s d } d } d } t i d | i } g } x| D]} t i | | } | o< | i d } | o h d d 6d d 6| } qd } q4 x| i D]*\ } } t i | t i t i B }
|
i | } | o | i
} | o1 | i d
d o | d d d
c | 7@ can be done this way:
pre. h1. This is a header 1.
Blocks may continue for multiple paragraphs of text. If you want
a block signature to stay "active", use two periods after the
signature instead of one. For example:
pre.. bq.. This is paragraph one of a block quote.
This is paragraph two of a block quote.
=p. Now we're back to a regular paragraph.
p. Becomes:
pre..
This is paragraph one of a block quote.
This is paragraph two of a block quote.
Now we’re back to a regular paragraph.
p. The blocks can be customised by adding parameters between the
signature and the period. These include:
dl. {style rule}:A CSS(Cascading Style Sheets) style rule.
[ll]:A language identifier (for a "lang" attribute).
(class) or (#id) or (class#id):For CSS(Cascading Style Sheets) class and id attributes.
>, <, =, <>:Modifier characters for alignment. Right-justification, left-justification, centered, and full-justification. The paragraph will also receive the class names "right", "left", "center" and "justify", respectively.
( (one or more):Adds padding on the left. 1em per "(" character is applied. When combined with the align-left or align-right modifier, it makes the block float.
) (one or more):Adds padding on the right. 1em per ")" character is applied. When combined with the align-left or align-right modifier, it makes the block float.
Here's an overloaded example:
pre. p(())>(class#id)[en]{color:red}. A simple paragraph.
Becomes:
pre. A simple paragraph.
s ^clear(?P[<>])?\.$i s (\n{2,})t alignments clear:left;t d? d@ dA g } dB dC g }
x2 | D]* \ } }
| i | o |
| d, (class#id){color:red}[en]. Paragraph.
or:
p{color:red}[en](class#id)>. Paragraph.
will have its parameters parsed to:
output = {'lang' : 'en',
'class': 'class',
'id' : 'id',
'style': 'color:red;text-align:right;'}
Note that order is not important.
R- s( \((?P[\w]+(\s[\w]+)*)(\#[\w]+)?\)R s" \([\w]*(\s[\w]+)*\#(?P[\w]+)\)R s \[(?P[\w-]+)\]R, s {(?P