U Sh;@sdZddlmZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z ddl mZm Z ddlmZddlmZmZmZmZmZmZmZmZdd lmZddlZddlZddlZdd lmZdd l m!Z!dd l"m#Z#m$Z$m%Z%m&Z&dd l"m'Z(ddl)m*Z*dd l+m!Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2m3Z3m4Z4ddl5m6Z6m7Z7m8Z8ddl9m:Z:ddl;mZ>ddl?m@Z@ddlAmBZBddlCmDZDddlEmFZFddlGmHZHmIZIddlJmKZKmLZLmMZMmNZNmOZOmPZPddlQmRZRmSZSddlTmUZUmVZVddlWmWZWerdd lXmYZYd!e(fd"d#d$d%ZZe[d&Z\e[d'Z]e[d(Z^dEd)d*d+d,d-d.Z_Gd/d0d0e>Z`d1d"d+d2d3d4d5d6Zad7d8d9d:d;Zbe[d<Zcd8d8d=d>d?ZddFd)d@dAd8dBdCdDZedS)Gz-Convert Markdown-it tokens to docutils nodes.) annotationsN) OrderedDict)contextmanagersuppress)datedatetime) ModuleType) TYPE_CHECKINGAnyCallableIterableIteratorMutableMappingSequencecast)urlparse)nodes) get_language) DirectiveDirectiveError directivesroles)Parser)Include) StringList)Filter)Reporter SystemMessage new_document)Lexer LexerError NumberLines) MarkdownIt) escapeHtml)RendererProtocol)Token)SyntaxTreeNode) inventory)findall)MdParserConfig UrlSchemeType)MockIncludeDirective MockingError MockInliner MockRSTParser MockStateMockStateMachine) MarkupErrorparse_directive_text) MystWarningscreate_warning) html_to_nodes)BuildEnvironmentZnotsetnodes.documentreturncCsPtjdddkr(ddlm}||}nddlm}||fd}t||dS) zJCreate a new docutils document, with the parser classes' default settings.N)rr)get_default_settings) OptionParser) components)settings)docutils__version_info__Zdocutils.frontendr=r>get_default_valuesr) source_pathZ parser_clsr=r@r>rET/root/rtd-docs/venv/lib/python3.8/site-packages/myst_parser/mdit_to_docutils/base.py make_documentAs    rGz^([a-zA-Z][a-zA-Z0-9+.-]*):z8{{\s*(uri|scheme|netloc|path|params|query|fragment)\s*}}z+^[\s]{0,3}([`]{3,10}|[~]{3,10}|[:]{3,10})\{r& int | Noneint)tokendefaultr:cCs0t|dds&|dk r|Std||jdS)z%Retrieve the initial line of a token.mapNztoken map not set: r)getattr ValueErrorrL)rJrKrErErF token_line[s  rOc @sPeZdZdZdZdddddZdd d d Zd d ddddZeddddZ dddddddddddZ dddd d!Z d"d d#d$d%d&Z ddd'd(Z ddd)d*Zddd-d.d/d-dd0d1d2Zedd3d.d4d5d6d7Zd8dd9d:d;Zd8dd9dd8dd?d@dAZddddCd8d3dDdEdFddGdHdIZdJd-ddKdLdMZdNdddOdPZd8dd9dQdRZd8dd9dSdTZd8dd9dUdVZd8dd9dWdXZd8dd9dYdZZd8dd9d[d\Zd8dd9d]d^Zd8dd9d_d`Zd8dd9dadbZ d8dd9dcddZ!d8dd9dedfZ"d8dd9dgdhZ#d8dd9didjZ$e%dd-dkdldmdnZ&d+dodde'j(dfddpd.d-dpddqdrd3ds dtduZ)d8dd9dvdwZ*d8dd9dxdyZ+ed.ddzd{Z,d8d-d3d3dd|d}d~Z-d8dd9ddZ.d8dd9ddZ/dd8dddddZ0d8dd9ddZ1d8dd9ddZ2d8dddddZ3d8dd9ddZ4d8dd9ddZ5dpdpdpdpddddZ6d8dd9ddZ7d8dd9ddZ8d8dd9ddZ9d8dd9ddZ:d8dd9ddZ;dd dd-ddddZd8dd9ddZ?d8dd9ddZ@d8dd9ddZAd8dd9ddZBd8dd9ddZCd8dd9ddZDd8dd9ddZEd8dd9ddZFd8dd9ddZGd8dd9ddZHd8dd9ddZId8dd9ddZJd8dd9ddZKd8dd9ddÄZLd8dd9ddńZMd8dd9ddDŽZNd8dd9ddɄZOddʜd8dddFdd˜dd̈́ZPddddd-dFd>dΜddЄZQd8dd9dd҄ZRd8dd9ddԄZSd8d.dd՜ddׄZTdS)DocutilsRendererzA markdown-it-py renderer to populate (in-place) a `docutils.document` AST. Note, this render is not dependent on Sphinx. rAr"None)parserr:cCs,||_ddtj|tjdD|_d|_dS)z,Load the renderer (called by ``MarkdownIt``)cSs(i|] \}}|dr|dkr||qS)render_render_children) startswith.0kvrErErF os  z-DocutilsRenderer.__init__..) predicateN)mdinspect getmembersismethodrules _inventories)selfrRrErErF__init__ls zDocutilsRenderer.__init__strnamecCs8|dkrtd|dtdt|jd|ddS)z.Warn when the renderer has not been setup yet.) md_env md_config md_optionsdocument current_nodereporterlanguage_module_rst_heading_offset_level_to_section'z;' attribute is not available until setup_render() is calledz' object has no attribute 'N)AttributeErrortype__name__)rbrfrErErF __getattr__ws  zDocutilsRenderer.__getattr__dict[str, Any]zMutableMapping[str, Any])optionsenvr:cCsl||_||_|d|_|dt|_|d|j|_|jj|_t|jj j |_ d|_ d|ji|_ i|_dS)z-Setup the renderer with per render variables.Z myst_configrjrkrN)rgrirhgetrGrjrkrlget_language_rstr@ language_codermrnro_heading_slugs)rbrvrwrErErF setup_renders  zDocutilsRenderer.setup_renderzBuildEnvironment | Noner9cCs(z |jjjWStk r"YdSXdS)z'Return the sphinx env, if using Sphinx.N)rjr@rwrqrbrErErF sphinx_envs zDocutilsRenderer.sphinx_envNline append_tor3rHznodes.Element | Noneznodes.system_message | None)messagesubtyperrr:cCst|j||||dS)zGenerate a warning, logging if it is necessary. If the warning type is listed in the ``suppress_warnings`` configuration, then ``None`` will be returned and no warning logged. r)r4rj)rbrrrrrErErFr4s zDocutilsRenderer.create_warningz list[Token])tokensr:c Cs|D]B}|jsq|jdd|jddg|_|jp6gD] }|j|_q8qt|}|jdi|jddD]R}g}|jD]<}|jdkr|jd}|jd|g|qx||qx||_qj|jD]T}d|j|j kr|j d|j|q|j d |jt j t |dd |jd qd S) zRender the tokens.rr5 foot_refsT)Z include_selffootnote_referencelabelrSNo render method for: rKrN)rLchildrenr&rg setdefaultwalkrrmetaappendr`r4r3 RENDER_METHODrOrk) rbrrJZ token_childZ node_treenodeZ new_childrenchildrrErErF_render_tokenss2        zDocutilsRenderer._render_tokenszSequence[Token]r8)rrgr:cCs0|||||t|||jS)a)Run the render on a token stream. :param tokens: list on block tokens to render :param options: params of parser instance :param md_env: the markdown-it environment sandbox associated with the tokens, containing additional metadata like reference info )r|_render_initialiserlist_render_finaliserj)rbrrvrgrErErFrenders zDocutilsRenderer.rendercCs$|jt|jj|jd|jddS)z&Initialise the render of the document.r)rjrrlN)rkextendhtml_meta_to_nodesrh html_metarjrlr}rErErFrsz#DocutilsRenderer._render_initialisec Cs|j|j_|jr,|jr,|j|jj|jjd<|jdgD]0}|jd|dt j |ddd|jdq:t }t |jt jD]}|d |krd ||d <q|r|jjr|jt jd gd |D]z}|jd |g}t|dkr|jd|dt j|jdt|dkr2|jd|dt j|jdq||dq|jdi}|r|jdk r~|jj|jji}||d<dD]n}||d} | dkrqt t| t t| } |jd| _| dd||j| d|qdS)z$Finalise the render of the document. myst_slugsZduplicate_refsz Duplicate reference definition: rrLrr5rrefnameTZ footnotesclassesrz0Multiple footnote definitions found for label: 'rp)rz*No footnote definitions found for label: 'Z wordcountN)wordsminutessourcenamesz wordcount-)r{rjrr~metadataZdocnamergrxr4r3Z MD_DEF_DUPErr(rrrhZfootnote_transitionrkr transitionlenZMD_FOOTNOTE_DUPEZMD_FOOTNOTE_MISSINGrender_footnote_referencerZsubstitution_definitionrdTextrZnote_substitution_def) rbZdup_refrrefnodeZfootrefZfoot_ref_tokensZwordcount_metadatarkeyvalueZsubstitution_noderErErFrsf             z!DocutilsRenderer._render_finaliseFrrIboolzNone | nodes.Element)textlinenoinlinetemp_root_nodeheading_offsetr:c s|rj|jnj|dj}|rD|djdkrD|d|D](}|jrH|jd||jd|g|_qHtfdd}||W5QRXdS)aRender unparsed text (appending to the current node). :param text: the text to render :param lineno: the starting line number of the text, within the full source :param inline: whether the text is inline or block :param temp_root_node: If set, allow sections to be created as children of this node :param heading_offset: offset heading levels by this amount  rZ front_matterr5c3sbj}_dk r:tj}jdd}jd<dV|_dk r^|jd<|_dS)Nr)rndictroitemsrgrx)Zcurrent_heading_offsetZcurrent_level_to_sectionZcurrent_root_noderrbrrErF_restoreis  z5DocutilsRenderer.nested_render_text.._restoreN) r\Z parseInlinergparserrpoprLrr) rbrrrrrrrJrrErrFnested_render_textJs  z#DocutilsRenderer.nested_render_text nodes.ElementzIterator[None])rrr:ccs,|r|j||j}||_dV||_dS)z9Context manager for temporarily setting the current node.N)rkr)rbrrrkrErErFcurrent_node_context|s  z%DocutilsRenderer.current_node_contextr&)rJr:cCsd|jpgD]T}d|j|jkr8|jd|j|q |jd|jtjt|dd|jdq dS)zRender the children of a token.rSrrrrN)rrrr`r4r3rrOrk)rbrJrrErErFrTs  z DocutilsRenderer.render_childrenc Cs.ttt||_W5QRX|jd|_dS)zCCopy the line number and document source path to the docutils node.rN)rrNrOrrjr)rbrrJrErErFadd_line_and_source_paths z)DocutilsRenderer.add_line_and_source_pathzlist[nodes.Element])nodes_rJr:cCs6|D],}|||t|D]}|||qqdS)zyCopy the line number and document source path to the docutils nodes, and recursively to all descendants. N)rr()rbrrJrrrErErFadd_line_and_source_path_rs z+DocutilsRenderer.add_line_and_source_path_rclass convertersaliasesz Sequence[str]z&dict[str, Callable[[str], Any]] | Nonezdict[str, str] | None)rJrkeysrrr:c Cs|dkr i}|dkri}|jD]\}}|||}||kr@q"|dkr`|dt|q"|dkrtt|}|d||j ||q"||krz||t|}WnFt k r|j d|d|j|t jt|dd |d Yq"YnX|||<q"dS) aCopy attributes on the token to the docutils node. :param token: the token to copy attributes from :param node: the node to copy attributes to :param keys: the keys to copy from the token (after aliasing) :param converters: a dictionary of converters for the attributes :param aliases: a dictionary mapping the token key name to the node key name NrridrzInvalid z attribute value: rrr)attrsrrxrrdsplitrfully_normalize_namerrjnote_explicit_targetrNr4r3INVALID_ATTRIBUTErO) rbrJrrrrrrrfrErErFcopy_attributess4   z DocutilsRenderer.copy_attributesz nodes.section)sectionlevelr:cstfdd|jD}|j|}|krr|dkrrd|d}|dkrZdd}|j|tj|j|jd ||||j<fd d |jD|_d S) zGUpdate the section level state, with the new current section and level.c3s|]}|kr|VqdSNrE)rW section_levelrrErF sz>DocutilsRenderer.update_section_level_state..r5z(Non-consecutive header level increase; Hz to HrzDocument headings start at Hz, not H1rcsi|]\}}|kr||qSrErE)rWrrrrErFrZsz?DocutilsRenderer.update_section_level_state..N) maxror4r3ZMD_HEADING_NON_CONSECUTIVErrkrr)rbrrZ parent_levelparentmsgrErrFupdate_section_level_states&      z+DocutilsRenderer.update_section_level_statezlist[SyntaxTreeNode]cCs@d}|p gD].}|jdkr&||j7}q |||jp4g7}q |S)zSpecial kludge for image `alt` attributes to conform CommonMark spec. Don't try to use it! Spec requires to show `alt` content with stripped markup, instead of simple escaping. r)rrcontentrenderInlineAsTextr)rbrresultrJrErErFrs    z#DocutilsRenderer.renderInlineAsTextc Cs`t|jr|jdjnd}|j||dd||||j|dd||W5QRXdS)NrrrrrTr)r paragraphrrrrrrT)rbrJpararErErFrender_paragraph s  z!DocutilsRenderer.render_paragraphcCs||dSr)rTrbrJrErErF render_inlineszDocutilsRenderer.render_inlinecCs|jt|jdSr)rkrrrrrrErErF render_textszDocutilsRenderer.render_textc Cs\t}|jr|j|d<|j||dd||||j|dd||W5QRXdS)NZbulletrrTr)rZ bullet_listmarkuprrrrT)rbrJ list_noderErErFrender_bullet_lists  z#DocutilsRenderer.render_bullet_listc Csd}d|jkr0ddddddt|jd|}tj|dd }|j|d <|j||d d ||||j|d d| |W5QRXdS)NarabicstyleZ loweralphaZ upperalphaZ lowerromanZ upperroman)decimalz lower-alphaz upper-alphaz lower-romanz upper-romanr)Zenumtypeprefixsuffix)rrstartrTr) rrxrdrZenumerated_listrrrrrT)rbrJrrrErErFrender_ordered_lists"    z$DocutilsRenderer.render_ordered_listc CsLt}|j||dd||||j|dd||W5QRXdS)NrrTr)rZ list_itemrrrrT)rbrJZ item_noderErErFrender_list_item1s  z!DocutilsRenderer.render_list_itemc Cs<t}||||j|dd||W5QRXdSNTr)rZemphasisrrrTrbrJrrErErF render_em8s zDocutilsRenderer.render_emcCs|jtddS)Nr)rkrrrrrErErFrender_softbreak>sz!DocutilsRenderer.render_softbreakcCs4|jtjdddd|jtjdddddS)Nrz
htmlformatz\\ latex)rkrrrawrrErErFrender_hardbreakAsz!DocutilsRenderer.render_hardbreakc Cs<t}||||j|dd||W5QRXdSr)rstrongrrrTrrErErF render_strongEs zDocutilsRenderer.render_strongc Cst}|j||dd||||j|ddr||d|jkrt|jdd}||||j|dd&|jt |jdt |dddW5QRXW5QRXdS) NrrTr attributionrrr) rZ block_quoterrrrTrrrrdrO)rbrJquoterrErErFrender_blockquoteKs     z"DocutilsRenderer.render_blockquotecCs$t}||||j|dSr)rrrrkrrrErErF render_hr[s zDocutilsRenderer.render_hrcCsft|j|j}||||j||dddddd|krVd|dkrV|dd|j|dS)N)rrlanguager)lexerlrcoder)rliteralrrrrrkrrErErFrender_code_inline`s z#DocutilsRenderer.render_code_inlinez list[int])emphasize_lines num_linesr:csLddlm}||}tfdd|Dr:tdfdd|DS)zeParse the `emphasize_lines` argument. Raises ValueError if the argument is invalid. r) parselinenosc3s|]}|kVqdSrrE)rWirrErFrvsz2DocutilsRenderer._parse_linenos..zout of range(1-csg|]}|kr|dqS)r5rE)rWxrrErF ysz3DocutilsRenderer._parse_linenos..)Z sphinx.utilranyrN)rrrhl_linesrErrF_parse_linenosms   zDocutilsRenderer._parse_linenosr5z str | Noneztype[nodes.Element]zlist[int] | str | None) r lexer_name number_lines lineno_startrrnode_clsrr:c  Cs|jdk r||||pdd} |r.rr)r~ isinstancerdr r splitlinesrNr4r3rrtuplerrhZhighlight_code_blocksr rlwarningr!rrrrr)rbrrrrrrrrrerrZ lex_tokensrrrErErFcreate_highlighted_code_block{sp    $   z.DocutilsRenderer.create_highlighted_code_blockc Cs|jr|jdnd}d}d}d|jkr:t|jdnd}d|jkrnttt|jd}d}W5QRX|j|j ||||j dt |dpd|d}| ||d |j |dS) Nrr5Femphasize-lines lineno-startTr)rrrrrr)inforrrdrxrrNrIrrrjrOrrkr)rbrJrrrrrrErErFrender_code_blocks,    z"DocutilsRenderer.render_code_blockc Cs|jr|jndjdd}|r(|dnd}t|dkr@|dnd}|jjs|jjs|dkrf||S|dr| dr| ||dd|S||jj krd d |j D}d |kr|d |d <|j ||||d S|s|jdk r|jjd|jjj}d}||jjk}d|j kr(t|j dnd}d|j kr^ttt|j d}d}W5QRX|j|j||||jdt|dpd|d} ||| d|j| dS)zRender a fenced code block.rr5maxsplitrz {eval-rst}{}cSsi|]\}}|t|qSrE)rdrVrErErFrZsz1DocutilsRenderer.render_fence..rrfadditional_optionsNhighlight_languagerrTr)rrrrrr) rstriprrrhcommonmark_onlygfm_onlyrender_restructuredtextrUendswithrender_directiveZfence_as_directiverrrr~Z temp_datarxconfigr&Znumber_code_blocksrdrrNrIrrrjrOrrkr) rbrJpartsrf argumentsrvrrrrrErErF render_fencesX      zDocutilsRenderer.render_fencecCs|jdk od|jjko|jjS)zOnly add mathjax ignore classes if using sphinx, and using the ``dollarmath`` extension, and ``myst_update_mathjax=True``. NZ dollarmath)r~rhZenable_extensionsZupdate_mathjaxr}rErErFblocks_mathjax_processings   z*DocutilsRenderer.blocks_mathjax_processing)rJrr title_noder:c Cst|}t|}|d||j||||jjkr>dSzt||j |jj }WnDt k r}z&|j t |tjt|dd|jdW5d}~XYn$X||d<|j|dd|f|j |<dS)z6Generate a heading target, and add it to the document.rNrrrslugZids) clean_astextrrrrjZnote_implicit_targetrhZheading_anchorscompute_unique_slugr{Zheading_slug_func Exceptionr4rdr3Z HEADING_SLUGrOrkr) rbrJrrr2 implicit_textrfr3errorrErErFgenerate_heading_target%s*    z(DocutilsRenderer.generate_heading_targetc Csnt|jd|j}|jdddk o4|j|jdk}|st|jtjtj fstj |j d|d}| ||| ||d|j|dd||W5QRX|||||dSt }| ||| ||d|dkr|jr|d d d g|||t|jr|jd j nd}| ||||||||W5QRX|||||||_dS) z#Render a heading, e.g. `# Heading`.r5rNrrrTrrZtex2jax_ignoreZmathjax_ignorer)rItagrnrgrxrkrrrjrrubricrrrrrTr9r1rrtitlerr)rbrJrZparent_of_temp_rootr;Z new_sectionr2rErErFrender_headingSs8      zDocutilsRenderer.render_headingcCs |jjs|jjs|jjr"||Sd|jkrLdt|jdkrL||Stt| dp\d}| drv| ||St |}|dkrdn|d}||jjkr|||jj|S|dkr||S|d kr||S|d kr||S|jd kr||S||S) aParse `` or `[text](link "title")` syntax to docutils AST: - If `myst_all_links_external` is True, forward to `render_link_url` - If the link token has a class attribute containing `external`, forward to `render_link_url` - If the link is an id link (e.g. `#id`), forward to `render_link_anchor` - If the link has a schema, and the schema is in `url_schemes` (e.g. `http:`), forward to `render_link_url` - If the link has an `inv:` schema, forward to `render_link_inventory` - If the link is an autolink/linkify type link, forward to `render_link_url` - Otherwise, forward to `render_link_internal` rZexternalhrefr#Nr5invpathprojectauto)rhr(r)Zall_links_externalrender_link_urlrrdrrattrGetrUrender_link_anchor REGEX_SCHEMEmatchgroupZ url_schemesrender_link_inventoryrender_link_pathrender_link_projectrrender_link_unknown)rbrJr>Z scheme_matchschemerErErF render_links2            zDocutilsRenderer.render_linkzNone | UrlSchemeType)rJ conversionr:c st}|||dddddg}|jjr>d|jd<d|jd<|j|||ddid tt| d pdd }d }|d k r*|j |}t |}||j |j|j|j|j|jd d|krttfdd|d}|j |}d|kr|jdks|jsttfdd|d}d|kr*|d|dt||d<|d k rn|j|dd|jt|W5QRXn$|j|dd||W5QRXd S)z{Render link token (including autolink and linkify), where the link has been identified as an external URL. rrreftitletargetrelZ_blankznoreferer noopenerr<rr>rN)urirNnetlocrAparamsqueryfragmenturlcs|ddSNr5rrxrIrHparsedrErFz2DocutilsRenderer.render_link_url..rCcs|ddSrZr[r\r]rErFr_r`rrefuriTr) r referencerrhZlinks_external_new_tabrrrrdrEr\normalizeLinkTextrrNrUrArVrWrXresubREGEX_URI_TEMPLATEZ normalizeLinkrrrr#rrkrrrT)rbrJrPref_nodeZattribute_keysrTr7Z_parsedrEr]rFrDs\            z DocutilsRenderer.render_link_urlcCs&|jdtjt|d|jd||S)z&Render a link token like ``.z,`path:` scheme not yet supported in docutilsrr)r4r3 NOT_SUPPORTEDrOrkrDrrErErFrKsz!DocutilsRenderer.render_link_pathcCsftt|dpd}|dr*|dd}|dr@|||S|jdtjt|d|j d | |S) z)Render a link token like ``.r>rzproject:Nr?z>`project:` scheme for file paths not yet supported in docutilsrr) rrdrErUrFr4r3rhrOrkrD)rbrJ destinationrErErFrLs    z$DocutilsRenderer.render_link_project)rJrRr:c Cs|t}|||d|d<|j||d<|j||dddid|j||jdkrx| || |W5QRXd S) zuRender link token like `[text](#target)`, to a local target. :target: the target id, e.g. `#target` TZid_linkrarrrQr<rQrrCN) rrbrr\rcrrkrrrrT)rbrJrRrgrErErFrF s    z#DocutilsRenderer.render_link_anchorc Csvt}||||j||dddidtt|dp:d|d<|j||j |dd | |W5QRXd S) aaRender link token `[text](link "title")`, where the link has not been identified as an external URL:: text `text` can contain nested syntax, e.g. `[**bold**](link "title")`. Note, this is overridden by `SphinxRenderer`, to use `pending_xref` nodes. rkr<rQrr>rrTrN) rrbrrrrdrErjZ note_refnamerrT)rbrJrgrErErFrMs   z$DocutilsRenderer.render_link_unknownc CsX|jtt|dpd}|jdko.t|j}t|}|j }d\}}}|j r|j d} t t | d}| d}| d}W5QRX|j||||d } | st||||} |jd | tjt|dd |jd d St| dkrRd} t||||} ddd| d | D} t| | kr(| d7} |jd| d| tjt|dd |jd | d}tjdddd}t|j|j|j|j|d<||||j ||dddid|j!rt"|j!|j#n|j#|d<d|kr|j$d|j%&|d<|j'||r"|(||)|W5QRXn2|j*r>|'t+|j*n|'t,|j|jd S)aCreate a link to an inventory object. This assumes the href is of the form `:#`. The path is of the form `::`, where each of the parts is optional, hence `:#` is also valid. Each of the path parts can contain the `*` wildcard, for example: `:key:*:obj#targe*`. `\*` is treated as a plain `*`. r>rrC)NNN:rr5r;)rRinvsdomainsotypeszNo matches for rrNz, cSs$g|]}t|j|j|j|jqSrE)r' filter_stringr@domainotyperf)rWmrErErFr csz:DocutilsRenderer.render_link_inventory..z, ...zMultiple matches for : F)ZinternalZ inv_matchrkr<rQrra )-r\rcrrdrErrrrrXrArr IndexErrorget_inventory_matchesr'rqr4r3Z IREF_MISSINGrOrkrjoinZIREF_AMBIGUOUSrrbr@rrrsrfrrbase_url posixpathlocrBversionr'rrrTrrr)rbrJr>explicitZ uri_partsrRrmrnro path_partsmatchesZ filter_strZshow_numZ matches_strrHrgrErErFrJ3s           z&DocutilsRenderer.render_link_inventoryzlist[inventory.InvMatch])rmrnrorRr:c Cs|jdkri|_|jjD]\}\}}|dkr.)rrrrrr)whar)rimagerrrdrErgrxrGrHosrAnormpathryrrrrZ length_or_percentage_or_unitlessZlength_or_unitlessrkr)rbrJZimg_noderjrErErF render_images<     zDocutilsRenderer.render_imagec CsJt}||||||d|j|dd||W5QRXdS)zRender an inline span token.rTrN)rrrrrrTrrErErF render_spans  zDocutilsRenderer.render_spanc Cst|dd}t|jtrdzt|j}Wqjtjjtjj fk r`|j dt j ||j dYdSXn|j}t|ts|j dt|t j ||j ddSdd|D}|r|j||jjjd }|j ||d r|jjr|d |d ddS) z Pass document front matter data.rrzMalformed YAMLrNzYAML is not a dict: cSsi|]\}}|dkr||qS))mystZmystnb substitutionsrrErVrErErFrZsz8DocutilsRenderer.render_front_matter..)rzr<z# )rOrrrdyamlZ safe_loadrRZ ParserErrorscannerZ ScannerErrorr4r3Z MD_TOPMATTERrkrrrrdict_to_fm_field_listrjr@rzrrxrhZtitle_to_headerr)rbrJpositiondatafields field_listrErErFrender_front_matters@      z$DocutilsRenderer.render_front_matterznodes.field_list)rrzrr:c Cst}|jd||_|_t|j}|D]\}}t|t t t t t fsTt|}t |}t}|jd||_|_||kr|||j||ddW5QRXn|t||7}t} || _| t|dt|7} | tj|f|g7} || 7}q.|S)aiRender each key/val pair as a docutils ``field_node``. Bibliographic keys below will be parsed as Markdown, all others will be left as literal text. The field list should be at the start of the document, and will then be converted to a `docinfo` node during the `docutils.docutils.transforms.frontmatter.DocInfo` transform (priority 340), and bibliographic keys (or their translation) will be converted to nodes:: {'author': docutils.nodes.author, 'authors': docutils.nodes.authors, 'organization': docutils.nodes.organization, 'address': docutils.nodes.address, 'contact': docutils.nodes.contact, 'version': docutils.nodes.version, 'revision': docutils.nodes.revision, 'status': docutils.nodes.status, 'date': docutils.nodes.date, 'copyright': docutils.nodes.copyright, 'dedication': docutils.nodes.topic, 'abstract': docutils.nodes.topic} Also, the 'dedication' and 'abstract' will be placed outside the `docinfo`, and so will always be shown in the document. If using sphinx, this `docinfo` node will later be extracted from the AST, by the `DoctreeReadEvent` transform (priority 880), calling `MetadataCollector.process_doc`. In this case keys and values will be converted to strings and stored in `app.env.metadata[app.env.docname]` See https://www.sphinx-doc.org/en/master/usage/restructuredtext/field-lists.html for docinfo fields used by sphinx. rTrr)rrrjrrrZbibliographic_fieldsrrrdrIfloatrrjsondumpsrrrrfield field_namer field_body) rbrrzrrZ bibliofieldsrrbodyZ field_noderErErFr s&(    z&DocutilsRenderer.dict_to_fm_field_listc CsR|js t|jd}|jst|jd}|js2tt}|ddg7<|||d||||j|t|j}d|g|}tj t|d}||7}|D]}tj |d} || 7}qt } || 7}| | | |W5QRXt|jdkrN|jd} t} || 7}| | $| jp0gD]} | | q2W5QRXdS) Nrrzcolwidths-autord)cols)colwidthr5)rAssertionErrorrtablerrrkrrtgroupcolspectheadrrender_table_rowtbody)rbrJheader header_rowrZmaxcolsZ colwidthsrrrrrrZbody_rowrErErF render_tableLs8             zDocutilsRenderer.render_tablec Cst}|j|dd|jp gD]}t}t|jrD|jdjnd}|d}|r|dkr|ddt t | d d |j|dd*|j|dd| |W5QRXW5QRXq"W5QRXdS) NTrrrr)ztext-align:leftztext-align:rightztext-align:centerrztext-rlr5) rrowrrentryrrrErrrdrrT)rbrJrrrrrrErErFrts"  $ z!DocutilsRenderer.render_table_rowcCsZ|jdtjt|d|jd|jtjdddd|||jtjddddd S) zRender a strikethrough token.z8Strikethrough is currently only supported in HTML outputrrrzrrzN) r4r3Z STRIKETHROUGHrOrkrrrrTrrErErFrender_ss zDocutilsRenderer.render_scCs.|j}t||}||||j|dSrrrmathrrkrrbrJrrrErErFrender_math_inlines  z#DocutilsRenderer.render_math_inlinecCs4|j}tj||ddd}||||j|dSNFnowrapnumberrr math_blockrrkrrrErErFrender_math_inline_doubles z*DocutilsRenderer.render_math_inline_doublecCs.|j}t||}||||j|dSrrrrErErFrender_math_singles  z#DocutilsRenderer.render_math_singlecCs4|j}tj||ddd}||||j|dSrrrrErErFrender_math_blocks z"DocutilsRenderer.render_math_blockcCs`|j}|j}tj||ddd}|||t|}|d||j|||j |dS)NFrr) rrrrrrrrjrrk)rbrJrrrrfrErErFrender_math_block_labels  z(DocutilsRenderer.render_math_block_labelcCsJtj|j|jddgd}|jddkr.d|d<||||j|dS)NTZamsmath)rrZnumbered*)rrrrrrkrrrErErFrender_amsmaths zDocutilsRenderer.render_amsmathcCsx|jd}td|d}||||sFd|d<|j|n|t|7}||d<|j||j |dS)zdFootnote references are added as auto-numbered, .i.e. `[^a]` is read as rST `[#a]_` rz[^]r5rCrN) rrrrisdigitrjZnote_autofootnote_refrZnote_footnote_refrkr)rbrJrRrrErErFrender_footnote_refs   z$DocutilsRenderer.render_footnote_refc Cs|jd}t}||||d||sJd|d<|j|n|td|7}|j ||j |||j |dd| |W5QRXdS)Nrrr5rCrTr) rrfootnoterrrrjZnote_autofootnoterZ note_footnoterrrT)rbrJrRrrErErFrs   z*DocutilsRenderer.render_footnote_referencecCs>t|j|j}|ddg7<||||j|dS)Nr block_break)rcommentrrrkr)rbrJrrErErFrender_myst_block_breaks z(DocutilsRenderer.render_myst_block_breakcCsT|j}t|}t|}|d|||||j||j|j|dS)Nr) rrrrRrrrjrrk)rbrJrrfrRrErErFrender_myst_targets   z#DocutilsRenderer.render_myst_targetcCs |jt|j|jdSr)rkrrrrr'rrErErFrender_myst_line_commentsz)DocutilsRenderer.render_myst_line_commentc Cs|jd}|j}d|d|jd}|jr2t|nd}t||j||j\}}|s|jd|dt j ||j d|j |dSt |}||||||\} } |j | | 7_ dS) Nrfrlz:``rzUnknown interpreted text role "z".r)rrrLrOrZrolermrlr4r3Z UNKNOWN_ROLErkrr-) rbrJrfrZ rawsourcerZ role_funcmessagesZinliner_nodesZ messages2rErErFrender_myst_roles,   z!DocutilsRenderer.render_myst_rolec Cs|jr|jndjdd}|r(|dnd}t|dkr@|dnd}|dr|dr|jdr|jdk svtd |j }d |j|_||_| ||dd |St j d d }| |||||d|r|d||j|d d||jt|dW5QRXdS)z0Render a div block, with ``:`` colon delimiters.rr5rrr!r"z:::Nz!"colon_fence" must have a `token`rr#T)Zis_divrrr)rr'rrrUr+rrJrcopyr,r containerrrrrrrO)rbrJr.rfr/Z linear_tokenrrErErFrender_colon_fence s"     z#DocutilsRenderer.render_colon_fencec Cstjddgd}|||d|||d|dko>|jdk }|j|dd d}|jp^gD]|}|jd kr(t}||||j|dd t |jr|jd j nd }|||||| |W5QRX|rd d l m }||j|jd|j|jd|jd}|j|W5QRXq`|jdkr|dkrb|jjdt|d}|j|g7_||>t} || ||j| dd | |W5QRXW5QRXq`|jjd|jt|d} |j| g7_q`W5QRXdS)zRender a definition list.simplerrrZglossaryrNTrdtrr)make_glossary_term)Znode_idrjddz?Found a definition in a definition list, with no preceding termrzIExpected a term/definition as a child of a definition list, but found a: )rZdefinition_listrrr~rrrrZdefinition_list_itemtermrrTZsphinx.domains.stdrrrrjrkrrlr8rO definition) rbrJrZ make_termsitemrrrr8r error_msgrErErF render_dl&s\             zDocutilsRenderer.render_dlc CsVtjdgd}|||d||||j|dd|jpBgdd}|rH|d}|jdkr|jj d |jt |d }|j |g7_ qHt }|||||7}t }|||||7}||||W5QRXt}|||||7}|rL|djd krL|d}||||W5QRXqLW5QRXdS) zRender a field list.rrrTrNrZfieldlist_namezCExpected a fieldlist_name as a child of a field_list, but found a: rZfieldlist_body)rrrrrrrrrrlr8rOrkrrrTr) rbrJrrrrrrrrErErFrender_field_listas:          z"DocutilsRenderer.render_field_listcCsxt}|jd|d<|jj|_|j|_dt||j}t|||D]}|drJ|j||qJ|j |j dS)z4Render the content of the token as restructuredtext.rrrN) rGrjr@rlrOrr.rrrkrr)rbrJZnewdocZ pseudosourcerrErErFr*s z(DocutilsRenderer.render_restructuredtextr$)rJrfr/r%r:cCs0t|}|j|||j||d}|j|7_dS)zRender special fenced code blocks as directives. :param token: the token to render :param name: the name of the directive :param arguments: The remaining text on the same line as the directive name. r$N)rO run_directiverrk)rbrJrfr/r%rZ nodes_listrErErFr,sz!DocutilsRenderer.render_directive)rf first_linerrr%r:c Cs||j_t||j|j}|\}}|sP|jd|tj|d} | rH| gng|St|t r~tj |j d<tj |j d<tj |j d<zt|||||d} WnHtk r} z*|jjd|d| |d} | gWYSd } ~ XYnX| jD]8} |j|d | j| j| jd k r| jn||jd qt|t rHt|||| j| j| j|d } nLt||}t|||}||| j| jt| j|jd || jd| j||d } z | }Wnt!k r} z0|jj"| j#| j|d}|t$%||7}|g}W5d } ~ XYn^t&k rL}z>|jjd|d|j'j(d |t$%|||d}|gWYSd }~XYnXt)|t*sjt+d|dt,t-|D]6}t)||t$j.svt+d|d|d||qv|S)aRun a directive and return the generated nodes. :param name: the name of the directive :param first_line: The text on the same line as the directive name. May be an argument or body text, dependent on the directive :param content: All text after the first line. Can include options. :param position: The line number of the first line :param additional_options: Additional options to add to the directive, above those parsed from the content. zUnknown directive type: rrz relative-docszheading-offset)rr%z Directive 'z': Nrur)rfklassr/rvrrrr) rfr/rvrrZcontent_offsetZ block_textstate state_machinez' cannot be mocked: z Directive "z" must return a list of nodes.z"" returned non-Node object (index z): )/rj current_liner directivermr4r3ZUNKNOWN_DIRECTIVE issubclassrflagZ option_specrAZnonnegative_intr2r1rlr8warningsrrrrrkr+r/rvrr0r/rZ body_offsetryrunrZsystem_messagerr literal_blockr, __class__rsrrrrangerNode)rbrfrrrr%outputZdirective_classrZ warn_noder^r8Z_warningZdirective_instancerrrZmsg_noderrrrErErFrs             zDocutilsRenderer.run_directivecCs|j|dddS)z#Render inline substitution {{key}}.TrNrender_substitutionrrErErFrender_substitution_inline(sz+DocutilsRenderer.render_substitution_inlinecCs|j|dddS)z"Render block substitution {{key}}.FrNrrrErErFrender_substitution_block,sz*DocutilsRenderer.render_substitution_block)rJrr:c Csnt|}|jj}|jdk r&|j|d<tjtjd}z|d|jd |}WnNt k r}z0|j d|j j d|tj||jdWYdSd}~XYnX|d|jd}d d |tjjD} t|jd t|j_| |jj} | r|j d | tj||jddS|jj| z4|rJt|sJ|j||d dn |||W5|jj| XdS)aSubstitutions are rendered by: 1. Combining global substitutions with front-matter substitutions to create a variable context (front-matter takes priority) 2. Add the sphinx `env` to the variable context (if available) 3. Create the string content with Jinja2 (passing it the variable context) 4. If the substitution is inline and not a directive, parse to nodes ignoring block syntaxes (like lists or block-quotes), otherwise parse to nodes with all syntax rules. Nrw)Z undefinedz{{z}}zSubstitution error:rurcSsh|]}|jdkr|jqS)rwre)rWnrErErF Vs z7DocutilsRenderer.render_substitution..sub_referencesz!circular substitution reference: Tr)rOrhrr~jinja2 EnvironmentZStrictUndefinedZ from_stringrrr6r4rrsr3Z SUBSTITUTIONrkrZfind_allrNamerMrjsetr intersectionupdatedifference_updateREGEX_DIRECTIVE_STARTrHr) rbrJrrZvariable_contextrwrenderedr8astZ referencesZcyclicrErErFr0sJ      z$DocutilsRenderer.render_substitution)FNr)F)r)N)r)N)Urs __module__ __qualname____doc__Z __output__rcrtr|propertyr~r4rrrrrrrrTrrrrrrrrrrrrrrrrrr staticmethodr rrrrr0r1r9r=rOrDrKrLrFrMrJrxrrrrrrrrrrrrrrrrrrrrrrrrr*r,rrrrrErErErFrPds  ( L2  -#   S3 .4.@ V%%*A(    ;%zrPrurz*list[nodes.pending | nodes.system_message])rrjrrlr:c CsT|sgSg}|D]8\}}t|p&d}t|}|d|_||_||d<z|sZtdt|D]j\} } d| kr| dkr| |d<qfd| krtd| | dd \} } | r| std | | || <qfWnNtk r"} z.| d |d | d }| |WYqW5d} ~ XYnXt t dd|gd}||| |q|S)zReplicate the `meta` directive, by converting a dictionary to a list of pending meta nodes See: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#html-metadata rrrz No content=rrfz no '=' in r5z malformed z"Error parsing meta tag attribute "z": .Nwriterr) componentrr)rrdrrrrrN enumeraterlowerr8rpendingrZ note_pending)rrjrrlrrrrZ meta_noderkey_part attr_nameZattr_valr8rrrErErFrusB        rrrd)rr:cCsP|}t|tjD] }d|d<qtt|tjD]}|j|q6|S)zCLike node.astext(), but ignore images. Copied from sphinx. rr) deepcopyr(rrrrrremoveZastext)rZimgrrErErFr4s  r4z[^\w\u4e00-\u9fff\- ])r<r:cCstd|ddS)zDefault slugify function. This aims to mimic the GitHub Markdown format, see: - https://github.com/jch/html-pipeline/blob/master/lib/html/pipeline/toc_filter.rb - https://gist.github.com/asabaylus/3071099 rrv-)_SLUGIFY_CLEAN_REGEXrer replace)r<rErErFdefault_slugifysrz Iterable[str]zNone | Callable[[str], str]) token_treeslugs slug_funcr:cCsj|dkr tn|}|}|d}ddd|jp2gD}||}d}||krf|d|}|d7}qF|S)zkCompute the slug for a token. This directly mirrors the logic in `mdit_py_plugins.anchors_plugin` Nr5rcss|]}|jdkr|jVqdS))rZ code_inlineN)rrr)rWrrErErFrs z&compute_unique_slug..r)rZ to_tokensryr)rrrrZ inline_tokenr<r3rrErErFr5s   r5)N)N)fr __future__rr]rrr{rd collectionsr contextlibrrrrtypesrtypingr r r r r rrr urllib.parserrArrrZdocutils.languagesrZdocutils.parsers.rstrrrrrZ RSTParserZ$docutils.parsers.rst.directives.miscrZdocutils.parsers.rst.languagesryZdocutils.statemachinerZdocutils.transforms.componentsrZdocutils.utilsrrrZdocutils.utils.code_analyzerrr r!Z markdown_itr"Zmarkdown_it.common.utilsr#Zmarkdown_it.rendererr$Zmarkdown_it.tokenr%Zmarkdown_it.treer&Z myst_parserr'Zmyst_parser._compatr(Zmyst_parser.config.mainr)r*Zmyst_parser.mockingr+r,r-r.r/r0Zmyst_parser.parsers.directivesr1r2Zmyst_parser.warnings_r3r4r6Zsphinx.environmentr7rGcompilerGrfrrOrPrr4rrr5rErErErFs   (                     0