;ò
6©Dc @ s) d Z d Z d k Z d k Z d k Z d k Z d k l Z d k l Z e ƒ Z
d k l Z d k
l Z l Z l Z l Z d k l Z d k l Z d k l Z l Z l Z l Z l Z l Z l Z l Z l Z l Z l Z l! Z! d
k" l# Z# d k$ l% Z% d k& l' Z' d k( Z( d
a) d k* l+ Z+ e+ d d ƒ Z, e+ d d ƒ Z- d Z. d Z/ d „ Z0 e
d Z1 e
d Z2 e
d Z3 e
d Z4 e
d Z5 e
d Z6 e
d Z7 e
d Z8 e
d Z9 e' ƒ Z: e: i; d d ƒ e: i; d d ƒ e: i; d! d" ƒ e: i; d# d ƒ e: i< d d ƒ e: i< d d# ƒ e2 Z= e5 Z> e
d$ Z? d% Z@ d& ZA e@ e eA e f ZB d' „ ZC d( „ ZD d) „ ZE d* „ ZF d+ „ ZG e e> d, „ ZH d- „ ZI d. d/ „ ZJ d0 „ ZK d1 d
d2 „ ZL d3 d4 d5 „ ZM d6 d7 „ ZN d8 „ ZO d9 „ ZP d: „ ZQ d; „ ZR d< „ ZS d= „ ZT d> „ ZU eV eV d? „ ZW d@ „ ZX dA „ ZY dB „ ZZ dC „ Z[ dD e i\ f dE „ ƒ YZ] eV eV dF „ Z^ dG e] f dH „ ƒ YZ_ dI „ Z` dJ e i\ f dK „ ƒ YZa dL e i\ f dM „ ƒ YZb dN „ Zc dO „ Zd dP „ Ze dQ kf lg Zg lh Zh d
eV eg eh dR „ Zi g aj g dS „ Zk dT „ Zl d S(U s; $Id: rl_doc_utils.py 2830 2006-04-05 15:18:32Z rgbecker $ s6
This module contains utilities for generating guides
N( s
RLDocTemplate( s
getStyleSheet( s inch( s letters A4s A5s A3( s defaultPageSize( s figures( s Paragraphs Spacers Preformatteds PageBreaks
CondPageBreaks Flowables Tables
TableStyles NextPageTemplates KeepTogethers Images
XPreformatted( s ParagraphStyle( s colors( s getSequenceri ( s Templates X$X$s Xs X^X^s %s%ss% %s%sc C s d k l } xî t t f t t f g D]Ô \ } } | } g } yŠ xƒ | o{ y | i | ƒ \ } } Wn
t ‚ qD X| \ } } | d j o | | }
n | | | f }
| i |
ƒ | | } qD WWn t j
o | i | ƒ n X| | d ƒ } q& W| Sd S( sê inside text find any subsequence of form $subsequence$.
Format the subsequence as code. If similarly if text contains ^arg^
format the arg as replaceable. The escape sequence for literal
$ is $\$ (^ is ^\^.
( s joins \s N( s strings joins QFcodetemplates codesubsts
QFreptemplates QFsubsts templates substs texts fragments partss PARSEs matchess indexs
ValueErrors prefixs codes parts append( s texts indexs prefixs codes joins fragments matchess partss substs templates part( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys quickfix+ s.
s Heading1s Heading2s Heading3s Heading4s BodyTexts Bullets Comments Centreds Captions Chapters 1s Sections Appendixs As Figures Codef5.5i c C sU d k } t i i | i ƒ t i d } t i i | d ƒ t i i | d ƒ f Sd S( s# return afm and pfb for Just's filesNs fontss Wargames.afms Wargames.pfb( s reportlabs oss paths dirnames __file__s seps folders join( s reportlabs folder( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys getJustFontPathse s c O s t Sd S( N( s None( s xs y( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys NOPl s c C s t ƒ i t | t ƒ ƒ d S( N( s getStorys appends
CondPageBreaks inchess inch( s inches( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys CPageo s c C s t ƒ i t ƒ ƒ d S( N( s getStorys appends PageBreak( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys newPager s c C s t | ƒ } t ƒ i | ƒ d S( N( s NextPageTemplates templNames fs getStorys append( s templNames f( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys nextTemplateu s c C s/ t | ƒ } | | | ƒ } t ƒ i | ƒ d S( N( s quickfixs texts klasss styles Ps getStorys append( s texts klasss styles P( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys discy s c C s t ƒ i d ƒ d S( Ns list1( s getSequencers reset( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys restartList~ s i c C sD t | ƒ } | o d | } n t | t ƒ } t ƒ i | ƒ d S( Ns# .( s quickfixs texts doBullets Paragraphs BUs Ps getStorys append( s texts doBullets P( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys list s
c C s3 d t | ƒ } t | t ƒ } t ƒ i | ƒ d S( Ns/ •( s quickfixs texts Paragraphs BUs Ps getStorys append( s texts P( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys bulletˆ s f0.10000000000000001c C s. t | ƒ t | d t d t ƒt | ƒ d S( Ns klasss style( s spaces befores discs texts Preformatteds exampletextstyles after( s texts befores after( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys eg s
f1.0i c C s, | o! t ƒ i t d | t ƒ ƒ n d S( Ni ( s inchess getStorys appends Spacers inch( s inches( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys space’ s s tc B s( e | ƒ e d ƒ | d | d Ud S( Ns producess
getStory().append(%s)
( s egs codes discs name( s codes name( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys EmbeddedCode• s
c C s t t ƒ ƒ Sd S( N( s lens getStory( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys startKeepš s c C s* t ƒ } t | | ƒ } | g | | )d S( N( s getStorys Ss KeepTogethers ss k( s ss ks S( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys endKeep s c C s t | d t d ƒd S( s$ Use this for the document title onlys styles TitleN( s discs texts
styleSheet( s text( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys title¢ s c C s@ t ƒ i t ƒ ƒ t d t | ƒ t ƒ } t ƒ i | ƒ d S( sq Use this for chapters. Lessons within a big chapter
should now use heading2 instead. Chapters get numbered.s Chapter N( s getStorys appends PageBreaks Paragraphs quickfixs texts H1s p( s texts p( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys heading1© s c C so t ƒ i t ƒ ƒ t o' t i d d ƒ t i d ƒ d a n t d t | ƒ t
ƒ } t ƒ i | ƒ d S( Ns Chapters Ai s Appendix ( s getStorys appends PageBreaks appmodes seqs setFormats resets Paragraphs quickfixs texts H1s p( s texts p( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys Appendix1° s
c C sC t ƒ i t t ƒ ƒ t d t | ƒ t ƒ } t ƒ i | ƒ d S( s Used to be 'lesson's+ N( s getStorys appends
CondPageBreaks inchs Paragraphs quickfixs texts H2s p( s texts p( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys heading2º s c C s? t ƒ i t t ƒ ƒ t t | ƒ t ƒ } t ƒ i | ƒ d S( s0 Used to be most of the plain old 'head' sectionsN( s getStorys appends
CondPageBreaks inchs Paragraphs quickfixs texts H3s p( s texts p( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys heading3À s c C s† t ƒ } t d ƒ d k } t i i t i i | i ƒ d d ƒ } t
ƒ i t t i i | | ƒ | | ƒ ƒ t d ƒ t | ƒ d S( Nf0.20000000000000001s docss images( s startKeeps ss spaces reportlabs oss paths joins dirnames __file__s
rlDocImageDirs getStorys appends Images widths heights endKeep( s paths widths heights reportlabs ss
rlDocImageDir( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys imageÆ s
'+
c C s? t ƒ i t t ƒ ƒ t t | ƒ t ƒ } t ƒ i | ƒ d S( s0 Used to be most of the plain old 'head' sectionsN( s getStorys appends
CondPageBreaks inchs Paragraphs quickfixs texts H4s p( s texts p( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys heading4Ï s c C s# t ƒ i t t | ƒ t ƒ ƒ d S( s Used for notes to ourselvesN( s getStorys appends Paragraphs quickfixs texts Comment( s text( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys todoÕ s c C s# t ƒ i t t | ƒ t ƒ ƒ d S( N( s getStorys appends Paragraphs quickfixs texts Centred( s text( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys centredÙ s c C s# t ƒ i t t | ƒ t ƒ ƒ d S( N( s getStorys appends Paragraphs quickfixs texts Caption( s text( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys captionÜ s s Illustrationc B s& t Z d Z e e d „ Z d „ Z RS( s® The examples are all presented as functions which do
something to a canvas, with a constant height and width
used. This puts them inside a figure box with a caption.c C s` t \ } } | o
| } n | o
| } n t i i | | | d t | ƒ ƒ | | _ d S( Ns2 Figure : ( s examplefunctiondisplaysizess stdwidths stdheights widths heights figuress Figures __init__s selfs quickfixs captions operation( s selfs operations captions widths heights stdheights stdwidth( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys __init__ä s
c C s | i | i ƒ d S( N( s selfs operations canv( s self( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys
drawFigureï s ( s __name__s
__module__s __doc__s Nones __init__s
drawFigure( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys Illustrationß s c C s/ t | | d | d | ƒ} t ƒ i | ƒ d S( Ns widths height( s Illustrations operations captions widths heights is getStorys append( s operations captions widths heights i( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys illustõ s s GraphicsDrawingc B s t Z d Z d „ Z d „ Z RS( sV Lets you include reportlab/graphics drawings seamlessly,
with the right numbering.c C s6 t i i | | i | i d t | ƒ ƒ | | _ d S( Ns2 Figure : ( s figuress Figures __init__s selfs drawings widths heights quickfixs caption( s selfs drawings caption( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys __init__ý s
c C s9 | i } | i | i | i ƒ | i | i d d ƒ d S( Ni ( s selfs drawings ds wraps widths heights drawOns canv( s selfs d( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys
drawFigure s ( s __name__s
__module__s __doc__s __init__s
drawFigure( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys GraphicsDrawingú s c C s# t | | ƒ } t ƒ i | ƒ d S( N( s GraphicsDrawings drawings captions ds getStorys append( s drawings captions d( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys draw
s s ParaBoxc B sY t Z d Z e d d d d d d d ƒZ d „ Z d „ Z d
„ Z d „ Z d „ Z RS(
sA Illustrates paragraph examples, with style attributes on the lefts descriptions fontNames Couriers fontSizei s leadingf9.5999999999999996c C se t i i | d d | ƒ | | _ | | _ t | | ƒ | _ | i | ƒ } t | | i ƒ | _
d S( Ni ( s figuress Figures __init__s selfs captions texts styles Paragraphs paras getStyleTexts styleTexts Preformatteds
descrStyles pre( s selfs texts styles captions styleText( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys __init__ s c C s | d | _ | d | _ | d | _ | d | _ | d | _ | i | i | _ d | | i | _ | i i
| i | i | ƒ \ } | _
| i
| i i | i i | _
| i i
| i | i | ƒ \ } | _ t | i | i
ƒ d d | _ t i i
| | | ƒ Sd S( sO Left 30% is for attributes, right 50% for sample,
10% gutter each side.f0.050000000000000003f0.10000000000000001f0.5f0.90000000000000002f0.94999999999999996f10.0f9.0N( s
availWidths selfs x0s x1s x2s x3s x4s widths dxs paras wraps availHeights paws pahs styles spaceBefores
spaceAfters pres prws prhs maxs figureHeights figuress Figure( s selfs
availWidths availHeights paws prw( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys wrap s
( ( c C s[ g } x4 | i i ƒ D]# \ } } | i d | | f ƒ q W| i ƒ t i | d ƒ Sd S( s, Converts style to preformatted block of texts %s = %ss
N(
s liness styles __dict__s itemss keys values appends sorts strings join( s selfs styles liness values key( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys getStyleText/ s
c C s® | i i ƒ | i i d ƒ | i i d d ƒ | i i | i | i | i d | i | i
| i | i i d d d d ƒ| i i d ƒ | i i | i | i | i d | i | i i | i
| i | i
i d d d d ƒ| i i | i | i | i d | i | i
i | i
| i | i
i d d d d ƒ| i i ƒ | i i | i | i | i | i d | i ƒ | i i | i | i | i | i d | i ƒ d S( Nf0.94999999999999996i i s fills strokef0.90000000000000002( s selfs canvs saveStates setFillGrays setDashs rects x2s x0s figureHeights pahs x3s paras heights styles spaceBefores
spaceAfters restoreStates drawOns pres x1s prh( s self( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys
drawFigure7 s*
c C sh g } xK | i i ƒ D]: \ } } | d d f j o | i d | | f ƒ q q Wt i | d ƒ Sd S( s, Converts style to preformatted block of texts names parents %s = %ss
N( s liness styles __dict__s itemss keys values appends strings join( s selfs styles liness values key( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys getStyleTextU s ( s __name__s
__module__s __doc__s ParagraphStyles
descrStyles __init__s wraps getStyleTexts
drawFigure( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys ParaBox s s ParaBox2c B s) t Z d Z d „ Z d „ Z d „ Z RS( sV Illustrates a paragraph side-by-side with the raw
text, to show how the XML works.c C sv t i i | d d | ƒ t d d d d d d d ƒ} t } | | _ t
d | d
| ƒ | _ t
| t ƒ | _ d S( Ni s descriptions fontNames Couriers fontSizei s leadingf9.5999999999999996s (
s figuress Figures __init__s selfs captions ParagraphStyles
descrStyles Bs textStyles texts Paragraphs lefts right( s selfs texts captions textStyles
descrStyle( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys __init__a s c C s | d | _ d | i } | i i | | ƒ \ } | _ | i i | | ƒ \ } | _ t | i | i ƒ d d | _
t i i | | | ƒ Sd S( Nf0.90000000000000002f0.40000000000000002f10.0f9.0( s
availWidths selfs widths colWidths lefts wraps availHeights lws lhs rights rws rhs maxs figureHeights figuress Figure( s selfs
availWidths availHeights rws lws colWidth( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys wrapm s
c C s` | i i | i | i d | i d | i ƒ | i i | i | i d | i d | i ƒ d S( Nf0.050000000000000003f0.94999999999999996f0.55000000000000004( s selfs lefts drawOns canvs widths figureHeights lhs rights rh( s self( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys
drawFigureu s
( s __name__s
__module__s __doc__s __init__s wraps
drawFigure( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys ParaBox2^ s c C s0 t | | d t | ƒ ƒ } t ƒ i | ƒ d S( Ns2 Figure : ( s ParaBoxs texts styles quickfixs captions ps getStorys append( s texts styles captions p( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys parabox s c C s- t | d t | ƒ ƒ } t ƒ i | ƒ d S( Ns2 Figure : ( s ParaBox2s texts quickfixs captions ps getStorys append( s texts captions p( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys parabox2… s c C s t ƒ i t i ƒ ƒ d S( N( s getStorys appends exampless NoteAnnotation( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys
pencilnote‹ s ( s tans greenc C s& t ƒ i t i | | | | ƒ ƒ d S( N( s getStorys appends exampless HandAnnotations xoffsets sizes fillcolors strokecolor( s xoffsets sizes fillcolors strokecolor( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys handnote s c C s
| a d S( N( s storys _story( s story( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys setStory— s c C s t Sd S( N( s _story( ( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys getStoryš s (m s __version__s __doc__s oss syss globs strings
rltemplates
RLDocTemplates
stylesheets
getStyleSheets
styleSheets reportlab.lib.unitss inchs reportlab.lib.pagesizess letters A4s A5s A3s reportlab.rl_configs defaultPageSizes reportlab.platypuss figuress Paragraphs Spacers Preformatteds PageBreaks
CondPageBreaks Flowables Tables
TableStyles NextPageTemplates KeepTogethers Images
XPreformatteds reportlab.lib.styless ParagraphStyles
reportlab.libs colorss reportlab.lib.sequencers getSequencers exampless appmodes t_parses Templates QFcodetemplates
QFreptemplates codesubsts QFsubsts quickfixs H1s H2s H3s H4s Bs BUs Comments Centreds Captions seqs setFormats chains lessonnamestyles discussiontextstyles exampletextstyles examplefunctionxinchess examplefunctionyinchess examplefunctiondisplaysizess getJustFontPathss NOPs CPages newPages nextTemplates discs restartLists lists bullets egs spaces EmbeddedCodes startKeeps endKeeps titles heading1s Appendix1s heading2s heading3s Nones images heading4s todos centreds captions Figures Illustrations illusts GraphicsDrawings draws ParaBoxs ParaBox2s paraboxs parabox2s
pencilnotes reportlab.lib.colorss tans greens handnotes _storys setStorys getStory(\ s
getStyleSheets setStorys BUs colorss discs Templates
CondPageBreaks examplefunctionyinchess illusts strings Paragraphs KeepTogethers CPages lists parabox2s seqs examplefunctionxinchess egs exampless exampletextstyles todos EmbeddedCodes
pencilnotes getJustFontPathss lessonnamestyles Comments Captions H2s
TableStyles Images titles H4s captions figuress discussiontextstyles NOPs
RLDocTemplates Flowables images Preformatteds QFsubsts paraboxs endKeeps Illustrations startKeeps __doc__s ParagraphStyles GraphicsDrawings Bs
styleSheets
XPreformatteds ParaBox2s nextTemplates Spacers H3s defaultPageSizes codesubsts quickfixs newPages H1s NextPageTemplates tans getStorys QFcodetemplates getSequencers examplefunctiondisplaysizess A3s A5s A4s ParaBoxs inchs __version__s Centreds draws Appendix1s globs syss
QFreptemplates heading4s PageBreaks heading2s heading3s letters heading1s centreds handnotes bullets oss restartLists spaces greens Table( ( sL /home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/rl_doc_utils.pys ? s¤
O
P!