c2iRdZddlmZddlmZmZdZerddlmZm Z ddlm Z ddl m Z ddl mZ d dd Z d dd Z d dd Zed k(reeddy y )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) PublisherNcF|||d}tj|||d|}|S)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 "

"). )input_encodingdoctitle_xforminitial_header_levelhtml)source source_pathdestination_pathwritersettings_overrides)r publish_parts) input_stringrrr doctitler overridespartss [/mnt/e/genesis-system/.venvs/voice-bridge/lib/python3.12/site-packages/docutils/examples.py html_partsrs:<$2#+)=?I   )) 5E Lc^t||||||}|d}|dk7r|j|}|S)aE 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" . )rrrr rr html_bodyunicode)rencode) rrrr output_encodingrrrfragments rrrDsE$ !{)%1  3E [!H)#???3 Orc |i}|d|iz}tjdddtjtj}|j d|d|j |||j|j|fS)zx Return the document tree and publisher, for exploring Docutils internals. Parameters: see `html_parts()`. Nr standalonerstnull) source_classdestination_class) settings_specrconfig_section) rr r StringInput NullOutputprocess_programmatic_settings set_sourcepublishdocument)rrr rr publishers r internalsr2as!"&6%GGI|UF,.NN13@I++$?H;?,A-    y ((r__main__test)NNrT)r str | bytesrStrPath | Nonerr7r Literal['unicode'] | strrboolrintreturnzdict[str, str])NNrrTr5)rr6rr7rr7r r8r!r8rr9rr:r;r6)NrN) rstrrr7r r8rzdict[str, Any] | Noner;z tuple[nodes.document, Publisher])__doc__ __future__rdocutilsrr TYPE_CHECKINGtypingrrrdocutils.nodesr docutils.corer rrr2__name__printrrrGs' # #&'.226:C $+, %*%!/% 8% % &) % # %R-1159B:C#*+ ) .7 8    %( <-19B:>)))6)#8)4 )2 z )F A r