body elements
and body elements
combinedtags in "simple" lists: list items contain either a single paragraph, a nested simple list, or a paragraph followed by a nested simple list. This means that this list can be compact: - Item 1. - Item 2. But this list cannot be compact: - Item 1. This second paragraph forces space between list items. - Item 2. - In non-list contexts, omit
tags on a paragraph if that
paragraph is the only child of its parent (footnotes & citations
are allowed a label first).
- Regardless of the above, in definitions, table cells, field bodies,
option descriptions, and list items, mark the first child with
'class="first"' and the last child with 'class="last"'. The stylesheet
sets the margins (top & bottom respectively) to 0 for these elements.
The ``no_compact_lists`` setting (``--no-compact-lists`` command-line
option) disables list whitespace optimization.
zz
zC
zO
)z—r" )())r" r" )dash parenthesesparensnonec b | |dd | |dd d S )Nfirstr last)set_class_on_childr* nodes r+ set_first_lastz HTMLTranslator.set_first_last s8 gq111 fb11111r- c | |dd | j | |dd d S )NaddressF)metapreCLASS)visit_docinfo_itembodyappendstarttagrQ s r+
visit_addressz HTMLTranslator.visit_address sK ie <<< tU) DDEEEEEr- c b | j d | d S Nz
)r[ r\ depart_docinfo_itemrQ s r+ depart_addressz HTMLTranslator.depart_address s0 &&& """""r- c |d dd | j | |d | | d S )Nclassesr
admonitiondiv)insertr[ r\ r] rS rQ s r+ visit_admonitionz HTMLTranslator.visit_admonition sZ Y q,/// tU33444 D!!!!!r- Nc : | j d d S N
r[ r\ rQ s r+ depart_admonitionz HTMLTranslator.depart_admonition $$$$$r- c t |j t j r%| j r | j d d S d S | |d d S )Nz
tags around paragraph ``node`` can be omitted.
Frd rM rN r Nc ^ g | ]*}t |t j t j f (|+S rB )rq r r rz r s r+ r z>HTMLTranslator.should_be_compact_paragraph.
author)
isinstanceparentr authorsauthor_in_authorsr[ r\ rZ rQ s r+ visit_authorzHTMLTranslator.visit_author sg dk5= 1 1 4%
- ,,,,,
-
-
# #D( 3 3 3 3 3r- c ~ t |j t j r d| _ d S | d S )NT)rq rr r rs rt ra rQ s r+
depart_authorz HTMLTranslator.depart_author s> dk5= 1 1 '%)D " " " $ $ & & & & &r- c @ | |d d| _ d S )Nrs F)rZ rt rQ s r+
visit_authorsz HTMLTranslator.visit_authors s& i000!& r- c . | d S r% )ra rQ s r+ depart_authorsz HTMLTranslator.depart_authors s """""r- c | j | |j j |j d d S )Nstub)colspecsr\ rr stubs
attributesgetrQ s r+
visit_colspecz HTMLTranslator.visit_colspec sG
T""" !4!4V!z0HTMLTranslator.depart_colspec.r[ r\ r] footnote_backrefsrQ s r+ visit_citationz HTMLTranslator.visit_citation tW-@-36 ' C C D D D
! ! !
t$$$$$r- c : | j d d S Nz
rl rQ s r+ depart_citationz HTMLTranslator.depart_citation + 0 1 1 1 1 1r- c d}d|v r ||d z
}n d|v r|| j j |d z
}| j | |dd|dg d S )N#refidrefnamea[zcitation-reference)suffixhrefrd )documentnameidsr[ r\ r] )r* rR r s r+ visit_citation_referencez'HTMLTranslator.visit_citation_reference s d?? DM !DD
$
DM)$y/: :D tS40D/E ' G G H H H H Hr- c : | j d d S )Nz]rl rQ s r+ depart_citation_referencez(HTMLTranslator.depart_citation_reference !!!!!r- c | j d | j | |ddd d S )Nz- : spanr"
classifierrX r[ r\ r] rQ s r+ visit_classifierz HTMLTranslator.visit_classifier sI HIII tVR| LLMMMMMr- c : | j d d S )Nrl rQ s r+ depart_classifierz HTMLTranslator.depart_classifier #####r- c d | j | |dd t | dk rj|d d d |d d d |dd D ] }|d d
d S d S ) Nrf compoundrX r rd zcompound-firstrO z
compound-lastzcompound-middler[ r\ r] len)r* rR childs r+ visit_compoundz HTMLTranslator.visit_compound s tU* EEFFF t99q== GI % %&6 7 7 7 HY & & 7 7 7 ad
;
;i ''(9:::: =
;
;r- c : | j d d S rj rl rQ s r+ depart_compoundz HTMLTranslator.depart_compound# rn r- c | j d | j | |dd | | d S )Nz
ddr" r[ r\ r] rS rQ s r+ visit_definitionz HTMLTranslator.visit_definition' sX ### tT266777 D!!!!!r- c : | j d d S )Nz
rl rQ s r+ depart_definitionz HTMLTranslator.depart_definition, r r- c f | j | |dd d S )NdldocutilsrX r rQ s r+ visit_definition_listz$HTMLTranslator.visit_definition_list0 s0 tT DDEEEEEr- c : | j d d S )Nz
rl rQ s r+ depart_definition_listz%HTMLTranslator.depart_definition_list3 r r- c d S r% rB rQ s r+ visit_definition_list_itemz)HTMLTranslator.visit_definition_list_item7 r- c d S r% rB rQ s r+ depart_definition_list_itemz*HTMLTranslator.depart_definition_list_item: r r- c | j | |dd | | d S )Ntdr" r rQ s r+ visit_descriptionz HTMLTranslator.visit_description> sB tT266777 D!!!!!r- c : | j d d S )Nzrl rQ s r+ depart_descriptionz!HTMLTranslator.depart_descriptionB r r- c | j t | j | j | |dddd | j d d| _ d S )Nr docinfor rK r zR%s:
r rd rM rO rN ) attvalastextrV r\ r[ r] languagelabelsr rq r Element)r* rR namerV meta_tags r+ rZ z!HTMLTranslator.visit_docinfo_itemW s6 ' ' $$ DKKMM : : : :
rl rQ s r+ depart_field_bodyz HTMLTranslator.depart_field_body r r- c | j | j | j f d | _ d|d v rd| _ n | j j rd|d vrd| _ | j r|D ]}|d }t
|t j sJ d |D }t | dk sHt | dk r,t
|d t j
t j f s d | _ n| j |
|d
d d d
| j d d S )Nr rd Tr rO c F g | ] }t |t j | S rB )rq r Invisibler ns r+
th)
r r field_name_limitr r r r\ r] rr r[ r* rR r s r+ visit_field_namez HTMLTranslator.visit_field_name s ? ) *DMM (DM M * $DKKMM""T]%CCC DO L "&-- T26= #0 #? #?!? #4!4
5
5
5
5
L # # # tT2>>>>?????r- c | j d | j | j d S )Nz:r rQ s r+ depart_field_namez HTMLTranslator.depart_field_name sB """ ))++,,,,,r- c | j | |dddd | j d | | d S )Nr zdocutils footnoter rK r r r rQ s r+ visit_footnotez HTMLTranslator.visit_footnote r r- c g }|d }| j j r|rt | dk rX| j d | j d | j d|d z nt |d D ]!\ }}| d|d|d "| j d d
| z | xj ddgz
c_ n,| j d | xj ddgz
c_ t | dk rF|s!|d d d |d
d d d S d S )Nbackrefsr r" z!r z z(%s) , rd rM rO rN )r footnote_backlinksr r r\ enumerater8 )r* rR backlinksr6 ibackrefs r+ r z HTMLTranslator.footnote_backrefs s
# = + % %8}}!! ##B''' ##F+++ ##$G&.qk%2 3 3 3 3 %.h$:$: 5 5LQ $$$(/&4 5 5 5 5 ##$4tyy7K7K$KLLL R( L # # # LLRH $LL t99q==
3Q "))'222 HY & &v . . . . . =r- c : | j d d S r rl rQ s r+ depart_footnotez HTMLTranslator.depart_footnote r r- c & d|d z }| j j }|dk r d}| j d n$|dk sJ d}| j d | j | |d |d
| d S ) Nr r bracketsr ] superscriptzr zfootnote-reference)rY r )r footnote_referencesr r\ r[ r] )r* rR r formatr s r+ visit_footnote_referencez'HTMLTranslator.visit_footnote_reference s T']" 2 Z F L $ $ $ $]**** F L ) ) ) tS&-A ' N N O O O O Or- c n | j | j dz d S )Nr7 r rQ s r+ depart_footnote_referencez(HTMLTranslator.depart_footnote_reference s1 ))++f455555r- c d S r% rB rQ s r+ visit_generatedz HTMLTranslator.visit_generated r r- z
image/svg+xmlz application/x-shockwave-flash)z.svgz.swfc i }|d }t j | d }|| j v r||d< | j | |d< n ||d< | d| |d< d|v r |d |d< d|v r |d |d< d |v rUt rd|vsd|vr| j j rt | } t j
| 5 }|j }d d d n # 1 swxY w Y | j j
| d
d d|vrd |d
z |d< d|vrd |d z |d< n# t t" f$ r Y nw xY wdD ]z}||v rtt% j d|| } | sJ t) | d t) |d dz z | d ||< {g }
dD ]U}||v rOt% j d|| r||xx dz
cc< |
|d|| d ||= V|
rd |
|d< t1 |j t4 j sCt1 |j t4 j r't1 |j j t4 j sd} nd} d|v rd|d z |d < || j v rG| j | j |d dfi || d| z d z | z d S | j | j |d | fi | d S ) Nurir datatypesrcaltr heightscale\/z%dpxr )r rS z([0-9.]+)(\S*)$d r+ z ^[0-9.]+$pxz: ; styler"
alignalign-%sr objectz img) r3 r4 splitextlowerobject_image_typesr r r file_insertion_enabledr Imager sizerecord_dependenciesaddreplaceOSErrorUnicodeEncodeErrorrematchfloatgroupr\ r8 rq rr r TextElement referencer[ r] r ) r* rR r rN ext imagepathr` img_sizeatt_namerm r[ r s r+ visit_imagezHTMLTranslator.visit_image" s- 5kg s##A&,,.. $) ) ) DL 237DLL DK ((5#..DK d?? MDM t !(^DN d??
>,,0D0DM8 1E ( - - > 22 ,c#&8, , , , , , , , , , , , , , ,
M599!))$446 6 6 d**(.!(<W
t++)/(1+)=X !34 D .
(
(t## H%7h H HE LL5 ekk!nn--tG}1E1E1KLL A&(DN ) # #H4 8L$x.99 +NNNd*NNN (((DNNN CDDDN , HHUOODM t{E$5 6 6 4;88 "4;#5u7HII FFF d?? &g 6DM $) ) ) I ]T]42 F F F F #xxs 3 3 46A BDJ K
L
L
L
L
L
I ]T]4 G G$ G G H H H H Hs6
E# ,D 4 E# DE# DE# #E76E7c d S r% rB rQ s r+ depart_imagezHTMLTranslator.depart_imageb r r- c | j | |dd| j z d d S )Nr z%s[labelrX )r[ r\ r] r r rQ s r+ visit_labelzHTMLTranslator.visit_labelg sW tT54<;K;K;M;M3M-4 ' 6 6 7 7 7 7 7r- c | j d| j d| j d S )NrC z r rQ s r+ depart_labelzHTMLTranslator.depart_labelk sK NT\ - - / /NN$,:J:J:L:LNNOOOOOr- c | j | |dd t | r#|d d d d S d S )Nlir" r rd rM r rQ s r+ visit_list_itemz HTMLTranslator.visit_list_itemo sc tT266777 t99 / GI % %g . . . . . / /r- c : | j d d S )Nz
rl rQ s r+ depart_list_itemz HTMLTranslator.depart_list_itemt r r- c b |d }d|v r@d |D |d< | j | |dd d S | j | |ddd | }| j | D ]}| ry| j | r1| j d| | z a| j | | |d v r| j | | j d
t | d z
z d z | j d
t j )Nrd codec g | ]
}|d k | S )r rB )r clss r+ r z0HTMLTranslator.visit_literal. r" r rY z option-groupzr )r option_limitr r r r\ r[ r] r/ s r+ visit_option_groupz!HTMLTranslator.visit_option_group s M & $DKKMM""T]%??? DO L < = = = = L # # # DM$ C CN Cd C C E E E !!! A r- c | j | j d | j | j d S )Nz
)r r r[ r\ rQ s r+ depart_option_groupz"HTMLTranslator.depart_option_group sV ))) ))++,,,,,r- c | j | |dddd | j d d S )Nr zdocutils option-listr rK r zH