+ VBiTRt^RIHtRt^RIt^RIt^RIt^RIt^RIt^RI H t H t H t H t HtHtHtHt^RIHt^RIHtRt]'d ^RIHt^R IHt!R R 4tR tR tRRRRRRRRRRRR]]3RltR2RltR3Rlt R] PBRRRRRRRRRRRR3Rlt"R] PBRRRRRRRRR3 Rlt#R4Rlt$RRRRRRRRRRRR]]R] PJ3Rlt&RRlt'Rt(R5RRllt)RRlt*R R!lt+R"R#lt,R$R%lt-R&R'lt.R(R)lt/R*R+lt0R,R-lt1R.R/lt2R0R1lt3R#)6a Calling the ``publish_*`` convenience functions (or instantiating a `Publisher` object) with component names will result in default behavior. For custom behavior (setting component options), create custom component objects first, and pass *them* to ``publish_*``/`Publisher`. See `The Docutils Publisher`_. .. _The Docutils Publisher: https://docutils.sourceforge.io/docs/api/publisher.html ) annotationsreStructuredTextN) __version____version_details__ SettingsSpecioutilsreadersparserswriters) OptionParser)doctreeF)TextIO)StrPathc<]tRt^%tRtRRRR]P R]PR3RRlltR%RRllt RRlt R R lt R&R lt R&R lt R RltR'RRlltR%RRlltR%RRlltR%RRlltRRltR(RltRRltRRltRRltR R!ltR"R#ltR$tR#)) PublisherzC A facade encapsulating the high-level logic of a Docutils system. NcV^8dQhRR/#returnNone)formats"2/usr/lib/python3.14/site-packages/docutils/core.py __annotate__Publisher.__annotate__+s4(4($(4(c  z\V\4'd\P!V4!V4p\V\4'dh\V\P4'd-VP fVP V4VP pM\P!V4!4p\V\4'd\P!V4!4pRVn Wn W nW0n W@nWPnW`nWpnWn\&P(!4VnR#)z Initial setup. The components `reader`, `parser`, or `writer` should all be specified, either as instances or via their names. N) isinstancestrr get_reader_classReaderparser set_parserr get_parser_classr get_writer_classdocumentreaderwritersource source_class destinationdestination_classsettingsr ErrorOutput_stderr) selfr'r"r(r)r*r+r,r-s &&&&&&&&&r__init__Publisher.__init__+s fc " "--f5f=F fc " "&'..11==(%%f- 11&9; fc " "--f57F ; 3 3 3 G(?& "3D  J~~' rcV^8dQhRR/#rr)rs"rrras - -4 -rc \P!V4pV!W#4VnVPPeVPPVnR#VPeVPVPnR#R#)zpSet `self.reader` by name. The "paser_name" argument is deprecated, use "parser" with parser name or instance. N)r r r'r")r0r'r" parser_name reader_classs&&&& r set_readerPublisher.set_readeras` //7 "67 ;;   )++,,DK [[ $!%DKK %rcV^8dQhRR/#rr)rs"rrrns%%%rc J\P!V4pV!4VnR#)zSet `self.writer` by name.N)r r%r()r0 writer_name writer_classs&& r set_writerPublisher.set_writerns// < "n rcV^8dQhRR/#rr)rs"rrrss ) )t )rc \P!R\^R7VPfVP WP V4VP fOVPP fVPP V4VPP VnVPfVPV4R#R#)zh`Publisher.set_components()` will be removed in Docutils 2.0. Specify component names at instantiation. stacklevelN) warningswarnPendingDeprecationWarningr'r7r"r#r(r=)r0 reader_namer5r;s&&&&rset_componentsPublisher.set_componentsss *0A ? ;;  OOKk B ;; {{!!) &&{3++,,DK ;;  OOK ( rc \P!4;_uu_4\P!R\R7V'dOV'g \ 4pWCnVP 4p\V4^8dVR,R8Xd R.Vn\VPVPVPV3VRWR7uuRRR4# +'giR#;i)ignore)category application applicationsT) componentsdefaultsread_config_filesusage descriptionN) rCcatch_warningsfilterwarningsDeprecationWarningrconfig_sectionsplitlenconfig_section_dependenciesr r"r'r()r0rQrR settings_specrWrOpartss&&&&&, r_setup_settings_parser Publisher._setup_settings_parsers  $ $ & &  # #H7I J$$0NM/=,&,,.u:>eBi=&@AO@PM= KKdkk)+!T 6' & & &s,C  A6C  C c lVP!WW43/VBpVP4VnVP#)aK Return settings from components and config files. Please set components first (`self.set_reader` & `self.set_writer`). Use keyword arguments to override component defaults (before updating from configuration files). Calling this function also sets `self.settings` which makes `self.publish()` skip parsing command line options. )r]get_default_valuesr-)r0rQrRr[rWrO option_parsers&&&&&, r get_settingsPublisher.get_settingss=33  KAIK %88: }}rcV^8dQhRR/#rr)rs"rrrs * *9= *rc VPfEV'dVP4M/pVPRR4VP!RRVRV/VBR#R#)N tracebackTr[rWr)r-copy setdefaultrb)r0r[settings_overridesrWrOs&&&& rprocess_programmatic_settings'Publisher.process_programmatic_settingss[ == 4F)..0BH    T 2    *M *-; * ( * !rcV^8dQhRR/#rr)rs"rrrs77,07rc VP!W#WE3/VBpVf\PR,pVPV4VnR#)z Parse command line arguments and set ``self.settings``. Pass an empty sequence to `argv` to avoid reading `sys.argv` (the default behaviour). Set components first (`self.set_reader` & `self.set_writer`). N:NN)r]sysargv parse_argsr-)r0rprQrRr[rWrOras&&&&&&, rprocess_command_linePublisher.process_command_linesG33  KAIK <88B\.P0!VPP(P*^ ,4X #V'd\.P0!X 4X # \dp RpT Pp Rp ? LRp ? i\ dap TP'ghTPP"'dTP%4hTP'T 4Rp^p Rp ? ELGRp ? ii;i)z Process command line options and arguments (if `self.settings` not already set), run `self.reader` and then `self.writer`. Return `self.writer`'s output. NT)r-rrrzpromptr'readr)r"r&rr(writer+assemble_partsrcode Exceptionrfdebugging_dumpsreport_Exceptionreporter max_levelexit_status_levelroexit) r0rprQrRr[rirWenable_exit_statusexit_rerror exit_statuss &&&&&&&& rpublishPublisher.publishs }}$))^2)//R2 KKM KKM KK,,T[[$++-1]]s!!!rc  VPP4'd!VPP4'gR#\P R8XdRMRpRpRpTP P^,pTPP^,p\R\ RT R T R T R 2 TPR 7R# \dR#i;i \\3dLOi;i) z=Print info and prompt when waiting for input from a terminal.NntzCtrl+ZzCtrl+Dzuseful formatsz Docutils z/ converting "z" into "zT". Call with option "--help" for more info. .. Waiting for source text (finish with z on an empty line):r) r)isattyr/AttributeErrorrnamer" supportedr( IndexErrorrr)r0eot_key in_format out_formats& rrPublisher.prompt>s KK&&((T\\-@-@-B-B.C!ggo(8 %   --a0I..q1J  +'&Kx |<99@ B## <<  !    +   s(CC#:C CCC-,C-cV^8dQhRR/#rr)rs"rrrTs222rc <\V\P4'dVPV4R #\V\4'dVP V4R #\V\ P4'd9VPPR\ P!V4,4R #\V\ P4'd9VPPR\ P!V4,4R #\R\ P!V4,VPR7\R\ \'d R\ R2MR R\P P#4^, R 2VPR7R #) z-Unable to open source file for reading: %s z2Unable to open destination file for writing: %s z%srzExiting due to error. Use "--traceback" to diagnose. Please report errors to . Include "--traceback" output, Docutils version (z []r), Python version (z5), your OS type & version, and the command line used.N)rr SystemMessagereport_SystemMessageUnicodeEncodeErrorreport_UnicodeErrorr InputErrorr/r error_string OutputErrorrrrroversionrXr0rs&&rrPublisher.report_ExceptionTs- eU00 1 1  % %e , 1 2 2  $ $U + r}} - - LL   (*,//%*@ A B r~~ . . LL  ??512 3 $//dll C 12= 3 32!<=""$Q'()  %)LL  2rcV^8dQhRR/#rr)rs"rrrjs!!T!rc \RVP: R\PPVP,: R2VP R7R#)zExiting due to level-z (z) system message.rN)rlevelrReporterlevelsr/rs&&rrPublisher.report_SystemMessagejs6 ++u~~44U[[AAC<< !rcV^8dQhRR/#rr)rs"rrros55D5rc VPVPVPpVPP \ P !V4: RVPP: RVPRR4: RVPRR4: RVPP: R\: R\PP4^,: R 24R #) z! The specified output encoding (z) cannot handle all of the output. Try setting "--output-encoding-error-handler" to * "xmlcharrefreplace" (for HTML & XML output); the output will contain "asciixmlcharrefreplacezU" and should be usable. * "backslashreplace" (for other output formats); look for "backslashreplacezr" in the output. * "replace"; look for "?" in the output. "--output-encoding-error-handler" is currently set to "z". Exiting due to error. Use "--traceback" to diagnose. If the advice above doesn't eliminate the error, please report it to . Include "--traceback" output, Docutils version (rz6), your OS type & version, and the command line used. N)objectstartendr/rrrr-rrrrrorrX)r0rdatas&& rrPublisher.report_UnicodeErroros||EKK 2 *u%}},,{{7$78{{7$67}}::CKK--/223 4 5r) r/r+r,r&r"r'r-r)r*r()NN)NNNN)NNNNN)NNNNNNF)rr __qualname____firstlineno____doc__r FileInput FileOutputr1r7r=rGr]rbrjrrrzrxryrrrrrrr__static_attributes__rrrrr%s#42<<!R]]4(l -% )6," *7"D FG>5 (T:.!,2,! 55rrz*%prog [options] [ []]zReads from (default is stdin) and writes to (default is stdout). See https://docutils.sourceforge.io/docs/user/config.html for a detailed settings reference.Tc \WV4T;'g T;'gRpT;'g T;'gRpT;'g T;'gRp\WWFR7pVPWWVWR7pV#)a( Set up & run a `Publisher` for command-line-based file I/O (input and output file paths taken automatically from the command line). Also return the output as `str` or `bytes` (for binary output document formats). Parameters: see `publish_programmatically()` for the remainder. - `argv`: Command-line argument list to use instead of ``sys.argv[1:]``. - `usage`: Usage string, output if there's a problem parsing the command line. - `description`: Program description, output for the "--help" option (along with command-line option descriptions). standalonerestructuredtext pseudoxml)r-rWr)_name_arg_warningrr)r'rFr"r5r(r;r-r[rirWrrprQrR publisherrs&&&&&&&&&&&&&& rpublish_cmdliners,k <  2 2{ 2 2lF  8 8{ 8 8&8F  1 1{ 1 1kF&&DI    [1C%NF Mrc\WWV 4\R/R\PbRVbRVbR\PbRVbRVbRVbRVbR VbR VbR VbR V bR V bRV bRV bRV bRVbwppV#)z Set up & run a `Publisher` for programmatic use with file-like I/O. Also return the output as `str` or `bytes` (for binary output document formats). Parameters: see `publish_programmatically()`. r*r)rvr,r+rwr'rFr"r5r(r;r-r[rirWrr)rpublish_programmaticallyrrr)r)rvr+rwr'rFr"r5r(r;r-r[rirWrr _publishers&&&&&&&&&&&&&&& r publish_filersk <1 /\\ /*0 />I /-- /  /3C / /$/ /  / $/ /  / $/ / /*7 /. /& /. /FJ Mrc\WFV4\R/R\PbRVbRVbR\PbRRbRVbRVbR VbR VbR VbR VbR VbRV bRV bRV bRV bRV bwrV#)u` Set up & run a `Publisher` for programmatic use with string I/O. Accepts a `bytes` or `str` instance as `source`. The output is encoded according to the `output_encoding`_ setting; the return value is a `bytes` instance (unless `output_encoding`_ is "unicode", cf. `docutils.io.StringOutput.write()`). Parameters: see `publish_programmatically()` or https://docutils.sourceforge.io/docs/api/publisher.html#publish-string This function is provisional because in Python 3 name and behaviour no longer match. .. _output_encoding: https://docutils.sourceforge.io/docs/user/config.html#output-encoding r*r)rvr,r+Nrwr'rFr"r5r(r;r-r[rirWrr)rrr StringInput StringOutput)r)rvrwr'rFr"r5r(r;r-r[rirWrrrs&&&&&&&&&&&&&& rpublish_stringrs4k <1 /^^ /,2 /@K /// / /,< / /$/ /  / $/ /  / $/ / /*7 /. /& /. /F Mrc\WWV 4\R/RVbRVbRVbR\PbRRbRVbRVbR VbR VbR VbR VbR V bRV bRV bRV bRV bRVbwppVPP #)a Set up & run a `Publisher`, and return a dictionary of document parts. Dictionary keys are the names of parts. Dictionary values are `str` instances; encoding is up to the client, e.g.:: parts = publish_parts(...) body = parts['body'].encode(parts['encoding'], parts['errors']) See the `API documentation`__ for details on the provided parts. Parameters: see `publish_programmatically()`. __ https://docutils.sourceforge.io/docs/api/publisher.html#publish-parts r)rvr*r,r+Nrwr'rFr"r5r(r;r-r[rirWrr)rrrrr(r\)r)rvr*rwr'rFr"r5r(r;r-r[rirWr_outputrs&&&&&&&&&&&&&&& r publish_partsr s2k <1 / /#. /=I /// / /,< / /$/ /  / $/ /  / $/ / /*7 /. /& /. /GY    ! !!rc \WFR4\R/RVbRVbRVbRRbRRbR\PbRVbR VbR VbR VbR R bRRbRVbRVbRV bRV bRV bwrV P#)zy Set up & run a `Publisher` for programmatic use. Return a document tree. Parameters: see `publish_programmatically()`. Nr)rvr*r+rwr,r'rFr"r5r(nullr;r-r[rirWrr)rrr NullOutputr&)r)rvr*r'rFr"r5r-r[rirWrrrs&&&&&&&&&&&& rpublish_doctreer 2sk51 / /#. /! / /,0 /-- /  / $/ /  / $/ / /$( / /*7 /. /?M /. /G   rc :\RRV4\\P!4T;'g T;'gR\P !V4\P VR7p V PWVV4V PRV4V PVR7#)u Set up & run a `Publisher` to render from an existing document tree data structure. For programmatic use with string output (`bytes` or `str`, cf. `publish_string()`). Note that ``document.settings`` is overridden; if you want to use the settings of the original `document`, pass ``settings=document.settings``. Also, new `document.transformer` and `document.reporter` objects are generated. Parameters: `document` is a `docutils.nodes.document` object, an existing document tree. Other parameters: see `publish_programmatically()`. This function is provisional because in Python 3 name and behaviour of the `io.StringOutput` class no longer match. Nr)r'r(r)r,r-r) rrr r!r DocTreeInputrrjryr) r&rwr(r;r-r[rirWrrs &&&&&&&&& rpublish_from_doctreerOs2dD+.!1!'!E!E;!E!E+!#!:,.OO#+ -I ++>; d$45   0B  CCrrrrc \P!R\^R7\WWFVR7pVP WV4VP WWVWR7pV#)u Set up & run a `Publisher` for command-line-based file I/O (input and output file paths taken automatically from the command line). Also return the output as `bytes`. This is just like publish_cmdline, except that it uses io.BinaryFileOutput instead of io.FileOutput. Parameters: see `publish_programmatically()` for the remainder. - `argv`: Command-line argument list to use instead of ``sys.argv[1:]``. - `usage`: Usage string, output if there's a problem parsing the command line. - `description`: Program description, output for the "--help" option (along with command-line option descriptions). Deprecated. Use `publish_cmdline()` (works with `bytes` since Docutils 0.20). Will be removed in Docutils 0.24. zg"publish_cmdline_to_binary()" is obsoleted by "publish_cmdline()" and will be removed in Docutils 0.24.rA)r-r,r)rCrDrVrrGr)r'rFr"r5r(r;r-r[rirWrrprQrRr+r,rrs&&&&&&&&&&&&&&&& rpublish_cmdline_to_binaryrtsg@ MM'(:qJ&&,=?I [{C    [1C%NF MrcV^8dQhRR/#rr)rs"rrrsCCTCrc \RV4F2wrVfK \P!RV RV RV R2\^R7K4 R#)r'Nz Argument "z1_name" will be removed in Docutils 2.0. Specify z name in the "z " argument.rA)r'r"r()ziprCrDrE) name_args componentname_args* rrrsS"#A9M   MMJyk244=;?%%.K{<4 C Nrc 8T;'g T;'gRpT;'g T ;'gRpT ;'g T ;'gRp \WhWVVR7pVPWV4VPW4VPWE4VP VR7pVV3#)aD Set up & run a `Publisher` for custom programmatic use. Return the output (as `str` or `bytes`, depending on `destination_class`, writer, and the "output_encoding" setting) and the Publisher object. Internal: Applications should not call this function directly. If it does seem to be necessary to call this function directly, please write to the Docutils-develop mailing list . Parameters: * `source_class` **required**: The class for dynamically created source objects. Typically `io.FileInput` or `io.StringInput`. * `source`: Type depends on `source_class`: - If `source_class` is `io.FileInput`: Either a file-like object (must have 'read' and 'close' methods), or ``None`` (`source_path` is opened). If neither `source` nor `source_path` are supplied, `sys.stdin` is used. - If `source_class` is `io.StringInput` **required**: The input as either a `bytes` object (ensure the 'input_encoding' setting matches its encoding) or a `str` object. * `source_path`: Type depends on `source_class`: - `io.FileInput`: Path to the input file, opened if no `source` supplied. - `io.StringInput`: Optional. Path to the file or name of the object that produced `source`. Only used for diagnostic output. * `destination_class` **required**: The class for dynamically created destination objects. Typically `io.FileOutput` or `io.StringOutput`. * `destination`: Type depends on `destination_class`: - `io.FileOutput`: Either a file-like object (must have 'write' and 'close' methods), or ``None`` (`destination_path` is opened). If neither `destination` nor `destination_path` are supplied, `sys.stdout` is used. - `io.StringOutput`: Not used; pass ``None``. * `destination_path`: Type depends on `destination_class`: - `io.FileOutput`: Path to the output file. Opened if no `destination` supplied. - `io.StringOutput`: Path to the file or object which will receive the output; optional. Used for determining relative paths (stylesheets, source links, etc.). * `reader`: A `docutils.readers.Reader` instance, name, or alias. Default: "standalone". * `reader_name`: Deprecated. Use `reader`. * `parser`: A `docutils.parsers.Parser` instance, name, or alias. Default: "restructuredtext". * `parser_name`: Deprecated. Use `parser`. * `writer`: A `docutils.writers.Writer` instance, name, or alias. Default: "pseudoxml". * `writer_name`: Deprecated. Use `writer`. * `settings`: A runtime settings (`docutils.frontend.Values`) object, for dotted-attribute access to runtime settings. It's the end result of the `SettingsSpec`, config file, and option processing. If `settings` is passed, it's assumed to be complete and no further setting/config/option processing is done. * `settings_spec`: A `docutils.SettingsSpec` subclass or object. Provides extra application-specific settings definitions independently of components. In other words, the application becomes a component, and its settings data is processed along with that of the other components. Used only if no `settings` specified. * `settings_overrides`: A dictionary containing application-specific settings defaults that override the defaults of other components. Used only if no `settings` specified. * `config_section`: A string, the name of the configuration file section for this application. Overrides the ``config_section`` attribute defined by `settings_spec`. Used only if no `settings` specified. * `enable_exit_status`: Boolean; enable exit status at end of processing? rrr)r-r*r,r )rrjrxryr)r*r)rvr,r+rwr'rFr"r5r(r;r-r[rirWrrrs&&&&&&&&&&&&&&&&& rrrsL 2 2{ 2 2lF  8 8{ 8 8&8F  1 1{ 1 1kF&&'3,=?I++>; - k<   2D  EF 9 rcV^8dQhRR/#rr)rs"rrr!s<<. rz(WARNING: Cannot set the default locale: z. N)r(rR) default_descriptionlocale setlocaleLC_ALLErrorrostderrrr)r( documenttypedoc_pathrRes&&& r rst2somethingr#!s L>"119 $ @   L+6; <<L CA3cJKKLs%A B #BB cV^8dQhRR/#rr)rs"rrr2s99$9rc \RRR4R#)htmlHTMLzuser/html.html#htmlNr#rrrrst2htmlr)2s&&"78rcV^8dQhRR/#rr)rs"rrr6sDD4Drc \RRR4R#)html4z XHTML 1.1zuser/html.html#html4css1Nr(rrr rst2html4r-6s';(BCrcV^8dQhRR/#rr)rs"rrr:sEE4Erc \RRR4R#)html5HTML5zuser/html.html#html5-polyglotNr(rrr rst2html5r2:s'7$CDrcV^8dQhRR/#rr)rs"rrr>s7747rc \RRR4R#)latexLaTeXuser/latex.htmlNr(rrr rst2latexr8>s'7$56rcV^8dQhRR/#rr)rs"rrrBsIIIrc \RRR4R#)manpagezUnix manual (troff)zuser/manpage.htmlNr(rrrrst2manr<Bs)24GHrcV^8dQhRR/#rr)rs"rrrFsEEErc \RRR4R#)odtzOpenDocument text (ODT)z user/odt.htmlNr(rrrrst2odtr@Fs%2ODrcV^8dQhRR/#rr)rs"rrrJsHHtHrc \RRR4R#)rzpseudo-XML (test)ref/doctree.htmlNr(rrr rst2pseudoxmlrDJs+24FGrcV^8dQhRR/#rr)rs"rrrNsFFFrc \RRR4R#)s5zS5 HTML slideshowzuser/slide-shows.htmlNr(rrrrst2s5rHNs$+-DErcV^8dQhRR/#rr)rs"rrrRsJJ4Jrc \RRR4R#)xetexzLaTeX (XeLaTeX/LuaLaTeX)r7Nr(rrr rst2xetexrLRs'57HIrcV^8dQhRR/#rr)rs"rrrVsDDDrc \RRR4R#)xmlzDocutils-native XMLrCNr(rrrrst2xmlrPVs%.0BCr)NNNNNNNNNNNNNNF) NNNNNNNNNNNNF)NNNNNNNF)r)4r __future__r __docformat__rrrrorCdocutilsrrrrrr r r docutils.frontendr docutils.readersr TYPE_CHECKINGtypingrdocutils.nodesrr default_usagerrrrrrr rBinaryFileOutputrrrr#r)r-r2r8r<r@rDrHrLrPrrrr[s #" <<<*$ &f5f5R = ) TTT!'+D'+$'5H D>'T'+#'444t%)$%*&"R)-!#TT!'+D', :"DJ&*|%)7I%){'+,015-115#'$1*=*.020C0C)XCrp<"9DE7IEHFJDr