3
T'ícw ã @ s6 d Z ddlmZmZ d
ddZdd d
ZdddZdS )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ÚioNÚunicodeTé c C s$ |||d}t j| ||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 "<h1>").
)Úinput_encodingZdoctitle_xformÚinitial_header_levelÚhtml)ÚsourceÚsource_pathÚdestination_pathÚwriter_nameÚsettings_overrides)r Z
publish_parts)Úinput_stringr