o iR@sdZddlmZddlmZmZdZer.ddlmZm Z ddlm Z ddl m Z ddl mZ d(d)ddZ d*d+ddZ d,d-d$d%Zed&kr\eed'dd Sd S).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) PublisherNunicodeT input_string str | bytes source_pathStrPath | Nonedestination_pathinput_encodingLiteral['unicode'] | strdoctitleboolinitial_header_levelintreturndict[str, str]cCs$|||d}tj|||d|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 "

"). )rdoctitle_xformrhtml)sourcerrwritersettings_overrides)r publish_parts)r rrrrr overridespartsr!W/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/docutils/examples.py html_partssr#output_encodingc Cs2t||||||d}|d}|dkr||}|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" . )r rrrrr html_bodyr )r#encode) r rrrr$rrr fragmentr!r!r"r%Ds r%rstrrdict[str, Any] | None tuple[nodes.document, Publisher]cCs^|duri}|d|iB}tjdddtjtjd}|jd|dd|||||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)rrrrr publisherr!r!r" internalsas     r9__main__test)NNr Tr )r r rrrrrrrrrrrr)NNr r Tr )r r rrrrrrr$rrrrrrr )Nr N) rr(rrrrrr)rr*)__doc__ __future__rdocutilsrr TYPE_CHECKINGtypingrrrdocutils.nodesr docutils.corer r#r%r9__name__printr!r!r!r"s:     )