U Peu@sdZdZddlZddlmZmZmZmZddlm Z ddl m Z ddl m Z mZmZmZmZmZmZmZddlmZdd lmZmZdd lmZdd lmZdd lmZdd l m!Z!ddl"m#Z#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2m3Z3m4Z4ddl/m5Z5m6Z6ddl7m8Z8dej9krGddde2j:e2j;ZGddde5Z?ded>e$ZXGd?d@d@e#ZYGdAdBdBeZZGdCdDdDeZ[GdEdFdFeZ\GdGdHdHe!Z]GdIdJdJeZ^GdKdLdLeZ_GdMdNdNe!Z`GdOdPdPeZaGdQdRdReZbGdSdTdTeZcGdUdVdVeZdGdWdXdXeZeGdYdZdZeZfGd[d\d\e2jgZhGd]d^d^e2jgZiejd_krdd`lkmlZlddlmZmeleLemjndadbdS)ca reStructuredText renderer ========================= .. versionadded:: 1.1.0 `reStructuredText `_ is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. .. note:: This widget requires the ``docutils`` package to run. Install it with ``pip`` or include it as one of your deployment requirements. .. warning:: This widget is highly experimental. The styling and implementation should not be considered stable until this warning has been removed. Usage with Text --------------- :: text = """ .. _top: Hello world =========== This is an **emphased text**, some ``interpreted text``. And this is a reference to top_:: $ print("Hello world") """ document = RstDocument(text=text) The rendering will output: .. image:: images/rstdocument.png Usage with Source ----------------- You can also render a rst file using the :attr:`~RstDocument.source` property:: document = RstDocument(source='index.rst') You can reference other documents using the role ``:doc:``. For example, in the document ``index.rst`` you can write:: Go to my next document: :doc:`moreinfo.rst` It will generate a link that, when clicked, opens the ``moreinfo.rst`` document. ) RstDocumentN)dirnamejoinexistsabspath)Clock)PY2)ObjectPropertyNumericProperty DictProperty ListPropertyStringPropertyBooleanPropertyOptionProperty AliasProperty)Builder)get_hex_from_colorget_color_from_hex)Widget) ScrollView) GridLayout)Label) AsyncImageImage) VideoPlayer) AnchorLayout) Animation)Logger)rst)roles)nodesfrontendutils) Directive directives) set_classesZKIVY_DOCc@s eZdZdS)role_docN__name__ __module__ __qualname__r+r+0/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/rst.pyr&]sr&c@s eZdZdS) role_videoNr'r+r+r+r,r-`sr-c@s2eZdZdZdZdZdZejejdZ ddZ dS) VideoDirectiveFrT)widthheightcCs*t|jtfd|jdi|j}|gS)Nsourcer)r%optionsr- argumentsselfnoder+r+r,runks zVideoDirective.runN) r(r)r*Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespacer$Znonnegative_intZ option_specr8r+r+r+r,r.csr.docclassesvideoa #:import parse_color kivy.parser.parse_color : content: content scatter: scatter do_scroll_x: False canvas.before: Color: rgba: parse_color(root.colors['background']) Rectangle: pos: self.pos size: self.size Scatter: id: scatter size_hint_y: None height: content.minimum_height width: root.width scale: 1 do_translation: False, False do_scale: False do_rotation: False GridLayout: id: content cols: 1 height: self.minimum_height width: root.width padding: 10 : markup: True valign: 'top' font_size: sp(self.document.base_font_size - self.section * ( self.document.base_font_size / 31.0 * 2)) size_hint_y: None height: self.texture_size[1] + dp(20) text_size: self.width, None bold: True canvas: Color: rgba: parse_color(self.document.underline_color) Rectangle: pos: self.x, self.y + 5 size: self.width, 1 : markup: True valign: 'top' size_hint_y: None height: self.texture_size[1] + self.my text_size: self.width - self.mx, None font_size: sp(self.document.base_font_size / 2.0) : size_hint: None, None height: label.height anchor_x: 'left' Label: id: label text: root.text markup: True valign: 'top' size_hint: None, None size: self.texture_size[0] + dp(10), self.texture_size[1] + dp(10) font_size: sp(root.document.base_font_size / 2.0) : cols: 2 content: content size_hint_y: None height: content.height Widget: size_hint_x: None width: 20 GridLayout: id: content cols: 1 size_hint_y: None height: self.minimum_height : cols: 1 content: content size_hint_y: None height: content.texture_size[1] + dp(20) canvas: Color: rgb: parse_color('#cccccc') Rectangle: pos: self.x - 1, self.y - 1 size: self.width + 2, self.height + 2 Color: rgb: parse_color('#eeeeee') Rectangle: pos: self.pos size: self.size Label: id: content markup: True valign: 'top' text_size: self.width - 20, None font_name: 'data/fonts/RobotoMono-Regular.ttf' color: (0, 0, 0, 1) : cols: 2 size_hint_y: None height: self.minimum_height : cols: 1 size_hint_y: None height: self.minimum_height : cols: 1 size_hint_y: None height: self.minimum_height canvas: Color: rgba: 1, 0, 0, .3 Rectangle: pos: self.pos size: self.size : content: content cols: 1 padding: 20 size_hint_y: None height: self.minimum_height canvas: Color: rgba: 1, 0, 0, .5 Rectangle: pos: self.x + 10, self.y + 10 size: self.width - 20, self.height - 20 GridLayout: cols: 1 id: content size_hint_y: None height: self.minimum_height : content: content cols: 1 padding: 20 size_hint_y: None height: self.minimum_height canvas: Color: rgba: 0, 1, 0, .5 Rectangle: pos: self.x + 10, self.y + 10 size: self.width - 20, self.height - 20 GridLayout: cols: 1 id: content size_hint_y: None height: self.minimum_height : size_hint: None, None size: self.texture_size[0], self.texture_size[1] + dp(10) : size_hint: None, None size: self.texture_size[0], self.texture_size[1] + dp(10) : cols: 1 size_hint_y: None height: self.minimum_height font_size: sp(self.document.base_font_size / 2.0) : cols: 2 size_hint_y: None height: self.minimum_height font_size: sp(self.document.base_font_size / 2.0) : cols: 2 size_hint_y: None height: self.minimum_height : markup: True valign: 'top' size_hint: 0.2, 1 color: (0, 0, 0, 1) bold: True text_size: self.width - 10, self.height - 10 valign: 'top' font_size: sp(self.document.base_font_size / 2.0) : cols: 1 size_hint_y: None height: self.minimum_height : cols: 2 size_hint_y: None height: self.minimum_height : markup: True valign: 'top' size_hint: 0.2, 1 color: (0, 0, 0, 1) bold: True text_size: self.width - 10, self.height - 10 valign: 'top' font_size: sp(self.document.base_font_size / 2.0) : size_hint_y: None height: self.minimum_height : cols: 1 size_hint_y: None height: self.minimum_height canvas: Color: rgb: .2, .2, .2 Line: points: [ self.x, self.y, self.right, self.y, self.right, self.top, self.x, self.top, self.x, self.y] : size_hint_y: None height: 20 canvas: Color: rgb: .2, .2, .2 Line: points: [self.x, self.center_y, self.right, self.center_y] : markup: True valign: 'top' size_hint_x: None width: self.texture_size[0] + dp(10) text_size: None, self.height - dp(10) font_size: sp(self.document.base_font_size / 2.0) : size_hint: 0.01, 0.01 : size_hint: None, 0.1 width: 50 font_size: sp(self.document.base_font_size / 2.0) : options: {'fit_mode': 'contain'} canvas.before: Color: rgba: (1, 1, 1, 1) BorderImage: source: 'atlas://data/images/defaulttheme/player-background' pos: self.x - 25, self.y - 25 size: self.width + 50, self.height + 50 border: (25, 25, 25, 25) c@s eZdZdS)RstVideoPlayerNr'r+r+r+r,r<sr<cseZdZdZedZedZedddZedZ edZ e dZ e dZd d Zd d Zeeed ddZeddddddZedZeiZedZedZedZegZeiZfddZddZddZ ddZ!d d!Z"d.d"d#Z#d$d%Z$d&d'Z%d(d)Z&d*d+Z'd,d-Z(Z)S)/rzbBase widget used to store an Rst document. See module documentation for more information. Nutf-8strict)r>ignorereplacexmlcharrefreplaceZbackslashreplac)r3FcCs t|jjSN)rcolors backgroundr6r+r+r,_get_bgcszRstDocument._get_bgccCst|dd|j_dS)Nr/)rrDrE)r6valuer+r+r,_set_bgcszRstDocument._set_bgc)rDT)bindcacheZe5e6e9ffZce5c00ffZ202020ffZ204a87ffZ000000ff)rElink paragraphtitlebulletZ204a9699c sFt|jd|_t|_tjtjfd |_ t t |j f|dS)N) components)rZcreate_trigger_load_from_text _trigger_loadrParser_parserr! OptionParserget_default_values _settingssuperr__init__)r6kwargs __class__r+r,r[s   zRstDocument.__init__cCs,|sdS|jdkr tt||_|dSrC) document_rootrr_load_from_sourcer6instancerHr+r+r, on_source%s  zRstDocument.on_sourcecCs |dSrC)rTrar+r+r,on_text.szRstDocument.on_textcCs |dS)z"Force document rendering. N)rSrFr+r+r,render1szRstDocument.rendercCst|r |St|j|S)zxGet the path for this filename. If the filename doesn't exist, it returns the document_root + filename. )rrr_r6filenamer+r+r, resolve_path6szRstDocument.resolve_pathc Csdt|d}|||}W5QRXtd|j}|j||t|}| ||j |j |<|S)zPreload a rst file to get its toctree and its title. The result will be stored in :attr:`toctrees` with the ``filename`` as key. rbDocument) openreaddecoder" new_documentrYrVparse_ToctreeVisitor walkabouttoctreetoctrees)r6rgencodingerrorsfdtextdocumentvisitorr+r+r,preload>s   zRstDocument.preloadcCs$||j}|||j|j|_dSrC)rhr2rzsource_encoding source_errorrwrfr+r+r,r`Ps  zRstDocument._load_from_sourcecGszv|jg|_i|_td|j}|j}trFt |t krF| d}|j ||t||}|||jppd|_WntdYnXdS)Nrjr=zNo titlezRst: error while loading text)contentZ clear_widgetsanchors_widgets refs_assocr"rnrYrwrtypestrrmrVro_VisitorrqrNr exception)r6largsrxrwryr+r+r,rSVs    zRstDocument._load_from_textcCs||dSrC)goto)r6r7refr+r+r, on_ref_presslszRstDocument.on_ref_pressc Gs|dr||_dS|j||}d}}|jD] }||jkr0|j|\}}qRq0|dkr^dS||j7}|j|}|jj|jj}}||j 8}| d|\}} t dt d| } t | ddd|dS)a?Scroll to the reference. If it's not found, nothing will be done. For this text:: .. _myref: This is something I always wanted. You can do:: from kivy.clock import Clock from functools import partial doc = RstDocument(...) Clock.schedule_once(partial(doc.goto, 'myref'), 0.1) .. note:: It is preferable to delay the call of the goto if you just loaded the document because the layout might not be finished or the size of the RstDocument has not yet been determined. In either case, the calculation of the scrolling would be wrong. You can, however, do a direct call if the document is already loaded. .. versionadded:: 1.3.0 .rstNrr/g?Z in_out_expo)Zscroll_ydt)endswithr2rgetr~Zanchorsxtopscatterr1Zconvert_distance_to_scrollmaxminrstart) r6rrZaxZayr7ZsxZsyZdxZdyr+r+r,ros$      zRstDocument.gotocCs|j|dSrC)r~appendr5r+r+r, add_anchorsszRstDocument.add_anchors)r=r>)*r(r)r*__doc__r r2r{rr|rwr_r Zbase_font_sizer show_errorsrGrIrZbackground_colorr rDrNrsZunderline_colorr r}rr r~rr[rcrdrerhrzr`rSrrr __classcell__r+r+r]r,rsR        Crc@seZdZedZedZdS)RstTitlerN)r(r)r*r sectionr rxr+r+r+r,rsrc@s$eZdZedZedZedZdS) RstParagraph N)r(r)r*r mxZmyr rxr+r+r+r,rsrc@seZdZedZedZdS)RstTermrPN)r(r)r*r rwr rxr+r+r+r,rsrc@seZdZedZdS) RstBlockQuoteNr(r)r*r r}r+r+r+r,rsrc@seZdZedZdS)RstLiteralBlockNrr+r+r+r,rsrc@s eZdZdS)RstListNr'r+r+r+r,rsrc@seZdZedZdS) RstListItemNrr+r+r+r,rsrc@seZdZedZdS) RstListBulletNr(r)r*r rxr+r+r+r,rsrc@s eZdZdS)RstSystemMessageNr'r+r+r+r,rsrc@seZdZedZdS) RstWarningNrr+r+r+r,rsrc@seZdZedZdS)RstNoteNrr+r+r+r,rsrc@s eZdZdS)RstImageNr'r+r+r+r,rsrc@s eZdZdS) RstAsyncImageNr'r+r+r+r,rsrc@seZdZedZdS)RstDefinitionListNrr+r+r+r,rsrc@seZdZedZdS) RstDefinitionNrr+r+r+r,rsrc@s eZdZdS) RstFieldListNr'r+r+r+r,rsrc@seZdZedZdS) RstFieldNameNrr+r+r+r,rsrc@s eZdZdS) RstFieldBodyNr'r+r+r+r,r src@s eZdZdS) RstFootnoteNr'r+r+r+r,r src@seZdZedZdS) RstFootNameNrr+r+r+r,rsrc@s eZdZdS) RstGridLayoutNr'r+r+r+r,rsrc@s eZdZdS)RstTableNr'r+r+r+r,rsrc@s eZdZdS)RstEntryNr'r+r+r+r,rsrc@s eZdZdS) RstTransitionNr'r+r+r+r,r"src@s eZdZdS) RstEmptySpaceNr'r+r+r+r,r&src@seZdZedZdS)RstDefinitionSpaceNrr+r+r+r,r*src@s4eZdZddZddZddZddZd d Zd S) rpcGs.g|_|_g|_d|_tjj|f|dS)NrP)rrcurrentqueuerwr NodeVisitorr[)r6rr+r+r,r[1s z_ToctreeVisitor.__init__cCs|j|||_dSrC)rrr)r6treer+r+r,push7s z_ToctreeVisitor.pushcCs|j|_dSrC)rpoprrFr+r+r,r;sz_ToctreeVisitor.popcCs|j}|tjkr\|d|ddgd}t|jtrD|jd|n |j|||n*|tjkrnd|_ n|tj kr|j |7_ dS)NidsnamesrP)rrrNchildrenr) r^r r isinstancerdictrrrNrwText)r6r7clsrr+r+r,dispatch_visit>s      z_ToctreeVisitor.dispatch_visitcCs4|j}|tjkr|n|tjkr0|j|jd<dS)NrN)r^r rrrNrwr)r6r7rr+r+r,dispatch_departurePs    z"_ToctreeVisitor.dispatch_departureN)r(r)r*r[rrrrr+r+r+r,rp/s rpc@sLeZdZddZddZddZddZd d Zd d Zd dZ ddZ dS)rc Gs||_d|_g|_d|_d|_d|_d|_d|_d|_i|_ d|_ ddddd|_ ddddd d d d d dg |_ t jj|f|dS)NrPFr)autonumautosym autonum_ref autosym_ref*u†u‡§¶#u∆u∏uѰuѦ)rootrN current_listridx_listrwtext_have_anchorr do_strip_text substitution foot_refblock footnotesfootlistr rr[)r6rrr+r+r,r[Zs8  z_Visitor.__init__cCs|j|j||_dSrC)rrr)r6Zwidgetr+r+r,rsz _Visitor.pushcCs|j|_dSrC)rrrrFr+r+r,rsz _Visitor.popcs0dfdd }|tjdd|tjdddS)NFc s*d}}j|dd}|D]}|dd}d}d|kr@|d}|dkrv|d7}|r`dt|nt|}|jj|<q|d krˆj|d t|d d} |rd| n| }|jj|<|d7}q|s|d d}|r|jj|<qd|d d}|jjkrjj||q|gjj|<qdS) NrF) conditionZascendrrPautor/backrefrrrrefname)Ztraverserrrrintr) rrrr_nodesfidrkeysymr7r6r+r,get_refss:      z%_Visitor.brute_refs..get_refs)rT)F)r footnotefootnote_reference)r6r7rr+rr, brute_refss&z_Visitor.brute_refsc s |j}|tjkr,||jj|| n|tjkr:dS|tjkrV|jd7_ nf|tj kr|j dd}|j d|j |< n:|tj kr|j |j d}t|tjr|j|7_ n|tjkrd}t}|j d}|j|||d}d|j kr |j d}|dkrD|jdd7<t|jd}|j dd}nn|d kr|jd } |j| d t| d d}|jd d7<|j dd}n|j dd}|dd}|jj|d} |jjd |d} | r||d n|} | sd| }nh| rNt| trNddt| D} ddd| dg|_d|dd| f}nd|dd| | f}t |j|d}|j||j!||j"|jj#d n|tj$kr|jd7_d}d}d}d|j kr|j d}|dkr|jdd7<t|jd}|j dd}nj|d krh|jd} |j| d t| d d}|jdd7<|j dd}n|j d}|dd}||7}|jj|d}|s|dkrt%dd|||jj&d |jj&d|f}|j|7_d|_'n|tj(kr"t)|j|jd }|j|||n|tjkr&t*|d!r|j+j,d"krLdS|j+j,d#kr^dS|j+j,d$krpdS|j+j,d%krdS|j-r|.d&d'}|.d(d'}|.d)d'}|.d(d'}|/d'rd'|0d'}|1d'r|2d'd'}|j1d'r|/d'r|dd}|j|7_n|tj3krd|_-t|j+tjrb|jr\|jd'|_d|_t4|jd*}t|jt5rd |_6|j|||n |tj7krt8}|j|||n|tj9kr|jd+7_n|tj:kr|jd,7_n|tj;kr"|jd-7_n|tjn\|tj?krt@}|j|||d|_An*|tjBkrt@}|j|||d|_An|tjCkr:d.}|jAdk r|jAd7_Ad/|jA}||d0}tD}|jtE||jd1|j|||n|tjFkrptG}|jjHrb|j|||nL|tjIkrtJ}|j|||j|jdk st>n|tjKkrtL}|j|||j|jdk st>n|tjMkr|d2}|d3d4}|d5|d6gd7d8|/d9rT|jjNrTt|jjN|dd}|/d:sl|/d;rtO|d<j"fd=d>d?ntP|d<tQd|jRd@}j"|Sd6dA||j|n|tjTk rtU|jd*}|j|||n|tjVk rVt|jtU s0t>tW|jd*}|j|||nf|tjXk rt|jtU stt>tY|jd*}|tZ|jd*|j|||n|tj[k rt\}|j|||n|tj]k r t^|jd*}|j|||n|tj_k r6t`}|j|||n|tjak rftbddB}|j|||nV|tjck r|jjdd7_dn6|tjek rt5}|j|||n |tjfk r|jtgn|tjhk rB|dC|dD}|jdE||jj&d |jj&df7_d|k rdC|k r|d|jj|dC<nz|tjik rd}d|k rj|dd}nd|k r|dd}|jdF|7_d|_'n"|tjk rtk|j|_ln |tmk rdS)GNr/rrrrPrrrrrrrrLz &bl;%s&br;cSs g|]\}}d||dfqS)z[ref=%s][u]%s[/u][/ref]r/r+).0irr+r+r, sz+_Visitor.dispatch_visit..z[i]( z, z )[/i]z[anchor=%s]&bl;%s&br;z#[anchor=%s][ref=%s]&bl;%s&br;[/ref])rxrwrz&bl;rr)r/rz:Too many autonumbered or autosymboled footnote references!z[anchor=%s][ref=%s][color=%s]%srMT)rrxparentsubstitution_definitionsubstitution_referencecommentr  z  )rxz[i]z[b]z#[font=fonts/RobotoMono-Regular.ttf]-z%d.rO)rwrxurialigncenterr0r1cSs"|dp |j|dp|jg|_dS)Nrr/)r0r1size)imgrr+r+r,set_sizes  z)_Visitor.dispatch_visit..set_size/zhttp://zhttps://r2cs SrCr+)aimageZ image_sizerr+r,z)_Visitor.dispatch_visit..)Zon_load) size_hint_yZanchor_xr1)r1)colsnameZrefuriz[ref=%s][color=%s]z [anchor=%s])nr^r rxrrr}rrrr attributesrrrrrrwrrr add_widgetrrrrrrcolorizelist enumeraterrrrrJrr ExceptionrDrrNrhasattrrtagnamerr@ startswithlstriprrstriprMrrr literal_blockremphasisstrongliteral block_quoterAssertionErrorenumerated_listrr bullet_list list_itemrrsystem_messagerrwarningrnoterrr_rrrr1setterdefinition_listrtermr definitionrr field_listr field_namer field_bodyrtablercolspecrentryZ transitionr referencetargetr&len doc_indexr-)r6r7rrrwZfootrrZnode_idrrLrZ colorizedZ ref_blockrefslabelZboxrOitemrrrlstrrZ fieldlistbodyr!r#r+rr,rs4                                                                                                                  z_Visitor.dispatch_visitcCs|j}|tjkr|n|tjkr8|jd8_n|tjkrzt|jtsRt |js`|j |_| |jd|nh|tj krnZ|tj krd|_t|jtst | |jd|n |tjkrt|jtst | |jjd|n|tjkr|j d7_ n|tjkr4|j d7_ n|tjkrR|j d7_ n|tjkrj|nx|tjkrd|_|nZ|tjkr|nB|tjkr|n*|tjkr|n|tjkr|n|tjkr|n|tjkr|n|tjkrPt|jt s6t | |jd |n|tj!krh|nz|tj"kr|nb|tj#krt|jt$st | |jd |n*|tj%kr|n|tj&kr|n|tj'krn|tj(kr|n|tj)kr.|j d 7_ n|tj*krT|| |jd n|tj+kr|j d 7_ |j d 7_ nb|t,kr8|j |j-d}|}|.dr|dd}n|d7}|j/0|}|j/1||}||j/j2kr |j/j2|}t3|r |dd}d||4|d f}|j d|j-||_ n|t5krd|6krX|dnd} d|6krr|dnd} |d} | 7dr|j/j8rt9|j/j8| dd} t:| d| | fd} t;d| dd} | <| |j<| dS)Nr/rNFrMrz[/i]z[/b]z[/font]rrz[/color][/ref]rLz&br;rrz[ref=%s]%s[/ref]r0ir1i,r2r)NN)r2Z size_hintr)rr1)=r^r rxrrrNrrrrrwset_textrrMrrrrr}rrrrrrrrrrrrrrrrrrr r!r"r#r$rrr&r'rrrhrzrsr&rr-attlistr r_rr<rr)r6r7rZdocnameZ rst_docnamergrNrrrwr0r1rr;anchorr+r+r,r-s                                                         z_Visitor.dispatch_departurecCs^|j}|dks|dkrd|}||||_|j|jjd|jrN|j|d|_d|_dS)Nrrz [b]%s[/b]rrPF)rwrrJrrrr)r6r7rrwr+r+r,r/s z_Visitor.set_textcCs d|jj||jjd|fS)Nz[color=%s]%s[/color]rM)rrDr)r6rwrr+r+r,rsz_Visitor.colorizeN) r(r)r*r[rrrrrr/rr+r+r+r,rXs'0w r__main__) runTouchAppr/r)or__all__osos.pathrrrrZ kivy.clockrZ kivy.compatrZkivy.propertiesr r r r r rrrZ kivy.langrZ kivy.utilsrrZkivy.uix.widgetrZkivy.uix.scrollviewrZkivy.uix.gridlayoutrZkivy.uix.labelrZkivy.uix.imagerrZkivy.uix.videoplayerrZkivy.uix.anchorlayoutrZkivy.animationrZ kivy.loggerrZdocutils.parsersrZdocutils.parsers.rstrZdocutilsr r!r"r#r$Zdocutils.parsers.rst.rolesr%environZInlineZ TextElementr&ZGeneralr-r.Zgeneric_docrolesitemsZrolenameZ nodeclassZ GenericRoleZgenericZ CustomRoleroleZregister_local_roleZregister_directive load_stringr<rrrrrrrrrrrrrrrrrrrrrrrrrrrrrprr(Z kivy.baser3sysargvr+r+r+r,s<  (                  )}