- 2Zope is ....' Note: This works for relative as well as absolute URLs. - Text enclosed by double quotes followed by a comma, one or more spaces, an absolute URL and concluded by punctuation plus white space, or just white space, is treated as a hyper link. For example: "mail me", mailto:amos@digicool.com. Is interpreted as 'mail me.' - Text enclosed in brackets which consists only of letters, digits, underscores and dashes is treated as hyper links within the document. For example: As demonstrated by Smith [12] this technique is quite effective. Is interpreted as '... by Smith [12] this ...'. Together with the next rule this allows easy coding of references or end notes. - Text enclosed in brackets which is preceded by the start of a line, two periods and a space is treated as a named link. For example: .. [12] "Effective Techniques" Smith, Joe ... Is interpreted as '[12] "Effective Techniques" ...'. Together with the previous rule this allows easy coding of references or end notes. - A paragraph that has blocks of text enclosed in '||' is treated as a table. The text blocks correspond to table cells and table rows are denoted by newlines. By default the cells are center aligned. A cell can span more than one column by preceding a block of text with an equivalent number of cell separators '||'. Newlines and '|' cannot be a part of the cell text. For example: |||| **Ingredients** || || *Name* || *Amount* || ||Spam||10|| ||Eggs||3|| is interpreted as::
Ingredients
Name Amount
Spam 10
Eggs 3
N(sgsub(ssplitsjoinsstripsfinds\( \|^\)\( *\) c sd}|}xdo||ddf}|o}|\}}t|d}t|d}||| }dd|ddd|||d|f}n ||SqWdS( s, Convert indentation tabs to spaces. siiis %s%ss iN( sresultsaStringsrests indent_tabs ts_resultssstartsgrpsslenslnlsindent( saStrings indent_tabsstartsindents ts_resultsslnlsgrpssrestsresult((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pysuntabifys    7icstt|d}| o dSn|d o|d=ndt}d|t|d|fSdS(s*Indent a string the given number of spacess sis s%s%s N(ssplitsuntabifysaStringsrslevelstabsjoin(saStringsindentsrstab((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pysindents  ics| ot|}nt|d}||jo |Sng}|i}||joFd||}x+t |dD]}|||qWn?||}x+t |dD]}|||qWt |dSdS(s@reindent a block of text, so that the minimum indent is as givenis s N( salready_untabifiedsuntabifysaStrings indent_levelslsindentsrsappendstabssplitsssjoin(saStringsindentsalready_untabifiedslsssrstabsappend((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pysreindents$       s \( *\)c sd}d|}t|}}xdo||ddf|}|o|\}}t|d}||d}||jo||djo=| od|fSn||jo |}nnn||fSq5WdS(sM Find the minimum indentation for a string, not counting blank lines. is iiN( sstartsaStringstextslensindentsls indent_spaces ts_resultssgrpssi( saStrings indent_spacesindents ts_resultssstartsgrpsstextsisl((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pys indent_levels"    ! cst|}||d}|d}x7||jo||d|jo|d}q6W|d|SdS(Nii(slenslistslsstartslevelsi(slistsstartslevelsisl((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pys paragraphss %cs| o gSnd}t|}g}xt||joct||}|d}|i||ddt||||!f||}q@W|SdS(Nii( slistsislenslsrs paragraphsssublensappends structure(slistsrssublensisl((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pys structures    3sTablecsDdZdZdZeiddZ dZRS(Ns& %s s %s s* %s
s[ \t\n]*\|\|([^|]*)csg|_ttt|d}x|D]}g}xdo|i |}| o dSn|i d}|i|id|t|joPn||}qOW|ii|q7WdSdS(sEparses a table and returns nested list representing the tables iiN(sselfstablesfiltersNonessplitsaParstextslinesrowstd_regsmatchsmosendspossappendsgroupslen(sselfsaParstd_regstextsmosposslinesrow((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pyscreates$     cs   g} x|iD ]} g}d}x^|D]S}|djo|d}qAn'|i|i||fd}qAW|i|i t |dqW|i t |dSdS(s'Creates an HTML representation of tableisN( s htmltablesselfstablesrowshtmlrowscolspanscellsappendsCELLsROWsjoinsTABLE(sselfscellscolspans htmltableshtmlrowsrow((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pyshtml s        $(sCELLsROWsTABLEsrescompilescreateshtml(((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pysTables    sStructuredTextcs5dZ#%deiddZOdZRS(sModel text as structured collection of paragraphs. Structure is implied by the indentation level. This class is intended as a base classes that do actual text output formatting. is \( ? *\)+ ? cs1%.1dtidtid}5ti|ti}7|id|}9dtidtid}=ti|ti}?|id|}Bt |d}C|djoDtiddE|}nG||_ Ht it|I|}Jtt|}Lt||_d S( sConvert a structured text string into a structured text object. Aguments: aStructuredString -- The string to be parsed. level -- The level of top level headings to be created. s "([%s0-9-_,./?=@~&]*)":s([-:%s0-9_,./?=@#~&]*?)s ([.:?;] )s\1\3 s "([%s0-9-_,./?=@~&]*)", s \2\3s \1\2\3s\1\2\3s\1\2\3(sssNonesstrongssubsunderscodesem(sssemsstrongsunderscode((sx/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/docstring/StructuredText/ClassicStructuredText.pysctagXs  sHTMLcsidZmoeideideiddZ~dZdZdZdZd Zd d Z d Z e id i e idi e idi e idi e ideii e idi dZRS(s+ An HTML structured text formatter. s
s