File: //lib/python3/dist-packages/docutils/__pycache__/examples.cpython-312.pyc
�
� ddy � �@ � d Z ddlmZmZ dd�Z dd�Z d d�Zy)
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.
� )�core�ioNc �F � |||d�}t j | ||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 "<h1>").
)�input_encoding�doctitle_xform�initial_header_level�html)�source� source_path�destination_path� writer_name�settings_overrides)r �
publish_parts)� input_stringr r r �doctitler � overrides�partss �3/usr/lib/python3/dist-packages/docutils/examples.py�
html_partsr s: � �4 $2�#+�)=�?�I�
� � ���)��y�
:�E� �L� c �^ � t | |||||�� }|d }|dk7 r|j |� }|S )aE
Given an input string, returns an HTML fragment as a string.
The return value is the contents of the <body> 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 r r r r r � html_body�unicode)r �encode) r r r r �output_encodingr r r �fragments r r r 5 sE � �
�!�{�)�%�� 1�
3�E�
�[�!�H��)�#��?�?�?�3�� �Or c �0 � |r|j � }ni }||d< t j di dt j �d| �d|�dt j
�dd�d|�d d�d
d �d d�d
d�dd�dd�dd�dd�d|�dd�dd��\ }}|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�
standalone�parser� parser_name�restructuredtext�writerr
�null�settings�
settings_specr �config_section�enable_exit_status� )�copyr �publish_programmaticallyr � StringInput�
NullOutputr' �document)r r r r r r �output�pubs r � internalsr5 M s� � � �&�+�+�-� �� �"0�I� � ��/�/� 6��^�^� 6�,8� 6� � 6� �-�-� 6� 6:� 6� *� 6�
� 6�
".� 6� �
6� "4�
6� � 6� "(� 6� � 6� &*� 6� ?H� 6� � 6� 15� 6�K�F�C� �:�:� � �� #�#r )NNr T� )NNr r Tr6 )NNr N)�__doc__�docutilsr r r r r5 r- r r �<module>r9 sC ��
� � AE�26�$%�!�H @D�8A�23��0 @D�;?�$r