>WBew@dZddlmZmZ ddZ ddZ d dZy) 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. )coreioNcF|||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_path writer_namesettings_overrides)r publish_parts) input_stringr r rdoctitler overridespartss 1lib/python3.12/site-packages/docutils/examples.py html_partsrs:4$2#+)=?I   )y :E 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" . )rr r rrr html_bodyunicode)rencode) rr r routput_encodingrrrfragments rrr4sE !{)%1  3E [!H)#???3 Orc0|r|j}ni}||d<tjdidtjd|d|dtj ddd|d dd d d dd dddddddddd|dddd\}}|j j|fS)zx Return the document tree and publisher, for exploring Docutils internals. Parameters: see `html_parts()`. r source_classr r destination_class destinationNr reader reader_name standaloneparser parser_namerestructuredtextwriterr nullsettings settings_specrconfig_sectionenable_exit_status)copyrpublish_programmaticallyr StringInput NullOutputr'document)rr r rrroutputpubs r internalsr5Ks&++-  "0I// 6^^ 6,8 6 6-- 66: 6* 6  6 ". 6  6 "4 6 6"( 6 6&* 6?H 6 615 6KFC ::   ##r)NNrT)NNrrTr6)NNrN)__doc__docutilsrrrrr5r-rrr9sC AE26$%!F@D8A23.@D;?$r