ó öÀ„\c@sædZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z ddlZddlmZmZddlmZddlmZdd lmZdd lmZmZmZdd lmZmZmZdd lm Z m!Z!dd l"m#Z#e$r_ddl%m&Z&m'Z'm(Z(m)Z)nej*d„Z+d„Z,d„Z-ej.dd„Z/ej.dd„Z0ej.dd„Z1e2dkrâej3e1ej.dƒƒndS(sÎ sphinx.cmd.build ~~~~~~~~~~~~~~~~ Build documentation from a provided source. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. iÿÿÿÿ(tprint_functionN(t SystemMessage(t text_typet binary_type(t__display_version__t package_dir(tSphinx(t SphinxError(t__(tTeetformat_exception_cut_framestsave_traceback(tredtnocolortcolor_terminal(tdocutils_namespacetpatch_docutils(t terminal_safe(tAnytIOtListtUnioncCsî|jrUddl}tttdƒƒd|ƒtjƒ|jtjƒdƒn•td|ƒ|j st|jr”tjd|ƒtd|ƒnt |t ƒr¼ttdƒd|ƒn.t |t ƒrtttdƒƒd|ƒtt|jdƒd|ƒnãt |tƒrRttd|jƒd|ƒttt|ƒƒd|ƒn˜t |tƒrÈtttd ƒƒd|ƒttt|ƒƒd|ƒt|ƒ}tttd ƒ|ƒd|ƒn"t |tƒr]d t|ƒkr]tttd ƒƒd|ƒttt|ƒƒd|ƒtd|ƒttd ƒd|ƒttdƒd|ƒntttdƒƒd|ƒttƒjƒd|ƒt|ƒ}tttd ƒ|ƒd|ƒttdƒd|ƒttdƒd|ƒdS(Niÿÿÿÿs5Exception occurred while building, starting debugger:tfileis interrupted!sreST markup error:is%s:sEncoding error:s[The full traceback has been saved in %s, if you want to report the issue to the developers.srecursion depthsRecursion error:s›This can happen with very large or deeply nested source files. You can carefully increase the default Python recursion limit of 1000 in conf.py with e.g.:s+ import sys; sys.setrecursionlimit(1500)sException occurred:siPlease also report this if it was a user error, so that a better error message can be provided next time.sbA bug report can be filed in the tracker at . Thanks!(tpdbtprintR Rt tracebackt print_exct post_mortemtsystexc_infot verbositytNonet isinstancetKeyboardInterruptRRtargsRtcategoryRt UnicodeErrorR t RuntimeErrortstrR trstrip(tappR"t exceptiontstderrRttbpath((s/lib/python2.7/site-packages/sphinx/cmd/build.pythandle_exception&sT        !   cCsN|dkrtjƒSt|ƒ}|dkrFtjtdƒƒ‚n|SdS(s½ Special type to handle 'auto' flags passed to 'sphinx-build' via -j flag. Can be expanded to handle other special scaling requests, such as setting job count to cpu_count. tautois&job number should be a positive numberN(tmultiprocessingt cpu_counttinttargparsetArgumentTypeErrorR(tvaluetjobs((s/lib/python2.7/site-packages/sphinx/cmd/build.pyt jobs_argumentYs     c Cs/tjdddtdƒdtdƒƒ}|jddd d d d d tƒ|jd dtdƒƒ|jddtdƒƒ|jddddtdƒƒ|jtdƒƒ}|jdddd ddddtdƒƒ|jdddd d dtd!ƒƒ|jd"ddd d#dtd$ƒƒ|jd%dd&d d'dtd(ƒƒ|jd)dd*dd+d,td d-dtd.ƒƒ|jd/ƒ}|jd0dd&d d1dtd2ƒƒ|jd3ddd d4dtd5ƒƒ|jd6dd7dd8d d9dgdtd:ƒƒ|jd;dd<dd8d d=dgdtd>ƒƒ|jd?dd@dd8d dAdgdtdBƒƒ|jdCddd dDdtdEƒƒ|jtdFƒƒ}|jdGddHd dIddJdtdKƒƒ|jdLddd dMdtdNƒƒ|jdOddd dPdtdQƒƒ|jdRddSdTdUddVdtdWƒƒ|jdXdYd dZddSdTd[dtd\ƒƒ|jd]dd^d d_dtd`ƒƒ|jdaddd dbdtdcƒƒ|jddddd dedtdfƒƒ|jdgddd dhdtdiƒƒ|jdjddd dkdtdlƒƒ|S(mNtusages5%(prog)s [OPTIONS] SOURCEDIR OUTPUTDIR [FILENAMES...]tepilogs5For more information, visit .t descriptions Generate documentation from source files. sphinx-build generates documentation from the files in SOURCEDIR and places it in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration settings. The 'sphinx-quickstart' tool may be used to generate template files, including 'conf.py' sphinx-build can create documentation in different formats. A format is selected by specifying the builder name on the command line; it defaults to HTML. Builders can also perform other tasks related to documentation processing. By default, everything that is outdated is built. Output only for selected files can be built by specifying individual filenames. s --versiontactiontversiontdestt show_versions %%(prog)s %st sourcedirthelps"path to documentation source filest outputdirspath to output directoryt filenamestnargst*s?a list of specific files to rebuild. Ignored if -a is specifiedsgeneral optionss-btmetavartBUILDERtbuildertdefaultthtmlsbuilder to use (default: html)s-at store_truet force_alls;write all files (default: only write new and changed files)s-Etfreshenvs4don't use a saved environment, always read all filess-dtPATHt doctreedirsPpath for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)s-jtNittypeR4s`build in parallel with N processes where possible (special value "auto" will set N to cpu-count)sbuild configuration optionss-ctconfdirsOpath where configuration file (conf.py) is located (default: same as SOURCEDIR)s-Ctnoconfigs*use no config file at all, only -D optionss-Ds setting=valuetappendtdefines(override a setting in configuration files-As name=valuet htmldefines pass a value into HTML templatess-ttTAGttagss*define tag: include "only" blocks with TAGs-ntnitpickys1nit-picky mode, warn about all missing referencessconsole output optionss-vtcountRis$increase verbosity (can be repeated)s-qtquiets,no output on stdout, just warnings on stderrs-Qt really_quiets#no output at all, not even warningss--colort store_consttconsttyesR-s-do emit colored output (default: auto-detect)s-Ns --no-colortcolortnos1do not emit colored output (default: auto-detect)s-wtFILEtwarnfiles)write warnings (and errors) to given files-Wtwarningiserrorsturn warnings into errorss --keep-goingt keep_goings)With -W, Keep going when getting warningss-TRs show full traceback on exceptions-PRsrun Pdb on exception(R1tArgumentParserRt add_argumentRtadd_argument_groupR5(tparsertgroup((s/lib/python2.7/site-packages/sphinx/cmd/build.pyt get_parserjs‚             $                    icCs!ddlm}|j|dƒS(sSphinx build "make mode" entry.iÿÿÿÿ(t make_modei(t sphinx.cmdRit run_make_mode(targvRi((s/lib/python2.7/site-packages/sphinx/cmd/build.pyt make_mainÊscCsstƒ}|j|ƒ}|jr-d|_n|jsE|j|_n|jsltjj |j dƒ|_n|j }g}x0|D](}tjj |ƒs‚|j |ƒq‚q‚W|rÎ|jtdƒ|ƒnytdƒ}|jƒ}Wntk rd}nX|jr)|r)|jtdƒƒn|jdksQ|jdkr[tƒ r[tƒntj}tj} tj} |jrˆd}n|jržd}} n| r|jryt|jdƒ} Wn3tk rø} |jtdƒ|j| fƒnXt| | ƒ} | } ni} x|jD]’}y|j d d ƒ\}}Wn$t!k ri|jtd ƒƒnX|r©t"|t#ƒr©y|j$|ƒ}Wq©t%k r¥q©Xn|| | s8       %3  `f