+
    VBi:(                       R t ^ RIHt Rt^ RIt^ RIt^ RIt^ RIHt ^ RI	t	^ RI	H
t
HtHtHt ^ RIHt Rt]'       d!   ^ RIHtHt ^ R	IHt ^ R
IHt ^ RIHt ^ RIHt  ! R R]
4      t ! R R]4      t ! R R]P:                  4      t]P>                  R,          R48  d%   ^ RIt ! R R] ! ]P                  ! 4       4      4      t/ RRbRRbRRbRRbRRbRRbRR bR!R"bR#R"bR$R"bR%R&bR'R&bR(R&bR)R&bR*R&bR+R,bR-R,bR.R/R0R1/Ct!R2 R3 lt"R# )5z0
This package contains Docutils Writer modules.
)annotationsreStructuredTextN)Path)	Component	languagesnodesutils)	universalF)AnyFinal)Output)LanguageModule)StrPath)	Transformc                     a  ] tR t^ t$ RtRtR]R&   RtR]R&   R V 3R lltR	t	R
]R&    R	t
R]R&    R	tR]R&    R	tR]R&    R R ltR R ltR R ltR R ltRtV ;t# )Writera  
Abstract base class for docutils Writers.

Each writer module or package must export a subclass also called 'Writer'.
Each writer must support all standard node types listed in
`docutils.nodes.node_class_names`.

The `write()` method is the main entry point.
writerr   component_typewritersconfig_sectionc                   V ^8  d   QhRR/#    returnzlist[type[Transform]] )formats   ">/usr/lib/python3.14/site-packages/docutils/writers/__init__.py__annotate__Writer.__annotate__/   s     N N 5 N    c                	   < \         SV `  4       \        P                  \        P                  \        P
                  .,           # N)superget_transformsr	   MessagesFilterMessagesStripClassesAndElements)self	__class__s   &r   r#   Writer.get_transforms/   s:    w%'9+=+=+4+C+C+4+L+L+N N 	Nr   Nznodes.document | Nonedocumentstr | bytes | NoneoutputzLanguageModule | NonelanguagezOutput | Nonedestinationc                   V ^8  d   QhRR/# r   r   Noner   )r   s   "r   r   r   F   s      $ r   c                	    / V n         R # r!   )partsr'   s   &r   __init__Writer.__init__F   s    %'
	r   c               $    V ^8  d   QhRRRRRR/# )r   r*   znodes.documentr.   r   r   r+   r   )r   s   "r   r   r   O   s&     3 3&3!3 &3r   c                    Wn         \        P                  ! VP                  P                  VP
                  4      V n        W n        V P                  4        V P                  P                  V P                  4      # )z
Process a document into its final form.

Translate `document` (a Docutils document tree) into the Writer's
native format, and write it out to its `destination` (a
`docutils.io.Output` subclass object).

Normally not overridden or extended in subclasses.
)r*   r   get_languagesettingslanguage_codereporterr-   r.   	translatewriter,   )r'   r*   r.   s   &&&r   r>   Writer.writeO   s`     !!..++ '%%dkk22r   c                   V ^8  d   QhRR/# r0   r   )r   s   "r   r   r   d   s     H H4 Hr   c                    \        R4      h)a  
Do final translation of `self.document` into `self.output`.  Called
from `write`.  Override in subclasses.

Usually done with a `docutils.nodes.NodeVisitor` subclass, in
combination with a call to `docutils.nodes.Node.walk()` or
`docutils.nodes.Node.walkabout()`.  The ``NodeVisitor`` subclass must
support all standard elements (listed in
`docutils.nodes.node_class_names`) and possibly non-standard elements
used by the current Reader as well.
z"subclass must override this method)NotImplementedErrorr4   s   &r   r=   Writer.translated   s     ""FGGr   c                   V ^8  d   QhRR/# r0   r   )r   s   "r   r   r   r   s     	5 	5 	5r   c                &   V P                   V P                  R&   V P                  P                  P                  V P                  R&   V P                  P                  P
                  V P                  R&   \        P                  V P                  R&   R# )z}Assemble the `self.parts` dictionary.  Extend in subclasses.

See <https://docutils.sourceforge.io/docs/api/publisher.html>.
wholeencodingerrorsversionN)r,   r3   r*   r:   output_encodingoutput_encoding_error_handlerdocutils__version__r4   s   &r   assemble_partsWriter.assemble_partsr   si    
 #kk

7!%!7!7!G!G

:MM""@@ 	

8 ( 4 4

9r   )r.   r*   r-   r3   )__name__
__module____qualname____firstlineno____doc__r   __annotations__r   r#   r*   r,   r-   r.   r5   r>   r=   rN   __static_attributes____classcell__r(   s   @r   r   r       s     %NE$%NE%N N
 '+H#*E!%F%
 '+H#*=!%K%
3*H	5 	5r   r   c                  &    ] tR t^~tRtR R ltRtR# )UnfilteredWriterz
A writer that passes the document tree on unchanged (e.g. a
serializer.)

Documents written by UnfilteredWriters are typically reused at a
later date using a subclass of `readers.ReReader`.
c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   UnfilteredWriter.__annotate__   s     . . 5 .r   c                	.    \         P                  ! V 4      # r!   )r   r#   r4   s   &r   r#   UnfilteredWriter.get_transforms   s     ''--r   r   N)rP   rQ   rR   rS   rT   r#   rV   r   r   r   rZ   rZ   ~   s    . .r   rZ   c                  B   a  ] tR t^tRtR V 3R lltRR R lltRtV ;t# )DoctreeTranslatorz
Generic Docutils document tree translator base class.

Adds auxiliary methods and attributes that are used by several
Docutils writers to the `nodes.NodeVisitor` abstract superclass.
c                   V ^8  d   QhRR/# r0   r   )r   s   "r   r   DoctreeTranslator.__annotate__   s     * *D *r   c                	H   < \         SV `  V4       VP                  V n        R # r!   )r"   r5   r:   )r'   r*   r(   s   &&r   r5   DoctreeTranslator.__init__   s    " ))r   c               $    V ^8  d   QhRRRRRR/# )r   uristroutput_pathzStrPath | Noner   r   r   )r   s   "r   r   rb      s!     1 1C 1l 1d 1r   c                   Vf   V P                   P                  pVP                  R4      '       d   \        P                  ! V4      # \
        P                  P                  V4      pVP                  R8w  d   \        RV R24      h\
        P                  P                  VP                  4      pV P                   P                  '       dM   VP                  R4      '       d6   \        V P                   P                  4      VP                  R4      ,          # \        V4      pV'       d`   VP                  4       '       gJ   \        V4      P                  P!                  4       p\        \"        P$                  ! RWT,          4      4      pV# )aw  Return filesystem path corresponding to a `URI reference`__.

The `root_prefix`__ setting` is applied to URI references starting
with "/" (but not to absolute Windows paths or "file" URIs).

If `output_path` (defaults to the `output_path`__ setting) is
not empty, relative paths are adjusted.
(To work in the output document, URI references with relative path
relate to the output directory.  For access by the writer, paths
must be relative to the working directory.)

Use case:
  The <image> element refers to the image via a "URI reference".
  The corresponding filesystem path is required to read the
  image size from the file or to embed the image in the output.

  A filesystem path is also expected by the "LaTeX" output format
  (with relative paths unchanged, relating to the output directory,
  set `output_path` to the empty string).

Provisional: the function's location, interface and behaviour
may change without advance warning.

__ https://www.rfc-editor.org/rfc/rfc3986.html#section-4.1
__ https://docutils.sourceforge.io/docs/user/config.html#root-prefix
__ https://docutils.sourceforge.io/docs/user/config.html#output-path
Nfile: z&Cannot get file path corresponding to ./)r:   rh   
startswithr   from_uriurllibparseurlsplitscheme
ValueErrorunquotepathroot_prefixremoveprefixis_absoluteparentresolver   relative_path)r'   rf   rh   	uri_partsrv   dest_dirs   &&&   r   uri2pathDoctreeTranslator.uri2path   s   8 --33K>>'""==%%LL))#.	r!EcU!LMM||##INN3==$$$)=)=112T5F5Fs5KKKDzt//11K(//779H++D(-@AD r   )r:   r!   )	rP   rQ   rR   rS   rT   r5   r   rV   rW   rX   s   @r   r`   r`      s    * *1 1r   r`   :Nr   Nc                  *    ] tR t^tRt]R 4       tRtR# )r   zK`pathlib.Path` with `from_uri()` classmethod backported from 3.13.
        c                   VP                  R4      '       g   \        RV: 24      hVR,          pVR,          R8X  d   VR,          pMVR,          R8X  d
   VR	,          pVR,          R8X  g   VR
,          R8X  d   VR,          R9   d
   VR,          pVR,          R8X  d   VR
,          R,           VR,          ,           pV ! \        P                  P	                  V4      4      pVP                  4       '       g   \        RV: 24      hV# )z,Return a new path from the given 'file' URI.rj   z!URI does not start with 'file:': :   NN:N   Nz///:r   NN:N   Nz//localhost/:   NN:N   Nrm   :r   r   Nz:|:r   NN:r   r   N|:zURI is not absolute: )rn   rt   rp   rq   ru   ry   )clsrf   rv   s   && r   ro   Path.from_uri   s     >>'** #DSG!LMMr7DBx5 Bxcn,CyBx5 T"X_cd9JBxCyCBx#~R0v||++D12D##%% #8!@AAKr   r   N)rP   rQ   rR   rS   rT   classmethodro   rV   r   r   r   r   r      s    	 
	 
	r   r   html	html4css1html4xhtml10html5html5_polyglotxhtmls5s5_htmllatexlatex2exelatexxetexluatexlualatexodfodf_odtodtooffice
openofficelibreofficepprint	pseudoxmlpformatpdfrlpdfxmldocutils_xmlc                    V ^8  d   QhRRRR/# )r   writer_namerg   r   ztype[Writer]r   )r   s   "r   r   r   
  s      # , r   c                N   V P                  4       p\        P                  W4      p \        P                  ! RV,           4      pVP                  #   \
         dJ     \        P                  ! T4      p TP                  #   \
         d   p\        RT  RT 24      hRp?ii ; ii ; i)z6Return the Writer class from the `writer_name` module.zdocutils.writers.zWriter "z" not found. N)lowerWRITER_ALIASESget	importlibimport_moduleImportErrorr   )r   namemoduleerrs   &   r   get_writer_classr   
  s    Dd)DJ(()<T)AB ==  J	J,,T2F ==  	J]3%HII	JJs)   A B$A??B 
BB  B$)r      )#rT   
__future__r   __docformat__r   sysrp   pathlibr   rL   r   r   r   r   docutils.transformsr	   TYPE_CHECKINGtypingr
   r   docutils.ior   docutils.languagesr   docutils.nodesr   r   r   rZ   NodeVisitorr`   version_infotyper   r   r   r   r   <module>r      s  
 #"  
    7 7 )!"1&-[5Y [5|.v ."=)) =@ B'!tGLLN# >&+ ;[ + +	
 	 9 W G g   Y 	   K  [!" %,r   