+ VBiRRt^RIHt^RIHtHtRt]'d^RIHtH t ^RIH t ^RI H t ^RI HtRR R lltRR R lltRR Rllt]R8Xd]!]!R4^,4R#R#)a1 This module contains practical examples of Docutils client code. Importing this module from client code is not recommended; its contents are subject to change in future Docutils releases. Instead, it is recommended that you copy and paste the parts you need into your own code, modifying as necessary. ) annotations)coreioF)AnyLiteral)nodes)StrPath) PublisherNc4V^8dQhRRRRRRRRRR R R R R /#) input_string str | bytes source_pathStrPath | Nonedestination_pathinput_encodingLiteral['unicode'] | strdoctitleboolinitial_header_levelintreturnzdict[str, str])formats"6/usr/lib/python3.14/site-packages/docutils/examples.py __annotate__rsK%%[%*%!/% 8% % &) % # %cJRVRVRV/p\P!WVRVR7pV#)a Given an input string, returns a dictionary of HTML document parts. Dictionary keys are the names of parts, and values are Unicode strings; encoding is up to the client. Parameters: - `input_string`: A multi-line text string; required. - `source_path`: Path to the source file or object. Optional, but useful for diagnostic output (system messages). - `destination_path`: Path to the file or object which will receive the output; optional. Used for determining relative paths (stylesheets, source links, etc.). - `input_encoding`: The encoding of `input_string`. If it is an encoded 8-bit string, provide the correct encoding. If it is a Unicode string, use "unicode", the default. - `doctitle`: Disable the promotion of a lone top-level section title to document title (and subsequent section title to document subtitle promotion); enabled by default. - `initial_header_level`: The initial level for header elements (e.g. 1 for "

"). rdoctitle_xformrhtml)sourcerrwritersettings_overrides)r publish_parts)r rrrrr overridespartss&&&&&& r html_partsr&s?<">!8')=?I   )) 5E Lrc8V^8dQhRRRRRRRRRRR R R R R R/#)r r r rrrrroutput_encodingrrrrrr)rs"rrrDsUK) .7 8    %( rc f\WVW5VR7pVR,pVR8wdVPV4pV#)a- Given an input string, returns an HTML fragment as a string. The return value is the contents of the element. Parameters (see `html_parts()` for the remainder): - `output_encoding`: The desired encoding of the output. If a Unicode string is desired, use the default value of "unicode" . )r rrrrr html_bodyunicode)r&encode) r rrrr(rrr%fragments &&&&&&& rr*r*DsA$ !)%1  3E [!H)#???3 Orc ,V^8dQhRRRRRRRRR R /#) r r strrrrrr"zdict[str, Any] | Nonerz tuple[nodes.document, Publisher]r)rs"rrras7))c)))6)#8)4 )rcVf/pVRV/,p\P!RRR\P\PR7pVP RVRR7VP W4VP4VPV3#)zl Return the document tree and publisher, for exploring Docutils internals. Parameters: see `html_parts()`. Nr standalonerstnull) source_classdestination_class) settings_specr"config_section) rr r StringInput NullOutputprocess_programmatic_settings set_sourcepublishdocument)r rrr"r$ publishers&&&& r internalsr?as!"&6%GGI|UF,.NN13@I++$?H;?,A-    y ((r__main__test)NNr+T)NNr+r+TrB)Nr+N)__doc__ __future__rdocutilsrr TYPE_CHECKINGtypingrrrdocutils.nodesr docutils.corer r&r*r?__name__printrrrrLsY # #&'%P:)2 z )F A r