B
öÀ„\ý. ã @ s8 d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z m
Z
ddl m Z ddl
mZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lm Z m Z m Z ddl m Z e !e"¡Z#y
ej$Z%W n e&k
rö ej'Z%Y nX dZ(G dd„ deƒZ)G dd„ deƒZ*G dd„ de ƒZ+dd„ Z,dS )zÌ
sphinx.builders.applehelp
~~~~~~~~~~~~~~~~~~~~~~~~~
Build Apple help books.
:copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
é )Úprint_functionN)ÚpathÚenviron)ÚStandaloneHTMLBuilder)Ústring_classes)Ú SphinxError)Ú__)Úlogging)Úbold)Ú
copy_asset)ÚMatcher)ÚcopyfileÚ ensuredirÚ
make_filename)Ú
htmlescapeaŠ
%(title)s
c @ s e Zd ZedƒZdS )ÚAppleHelpIndexerFailedzHelp indexer failedN)Ú__name__Ú
__module__Ú __qualname__r Úcategory© r r ú8lib/python3.7/site-packages/sphinx/builders/applehelp.pyr ? s r c @ s e Zd ZedƒZdS )ÚAppleHelpCodeSigningFailedzCode signing failedN)r r r r r r r r r r C s r c sh e Zd ZdZdZedƒZdZddddd d
gZdZ d Z
dZ ‡ fd d
„Z ‡ fdd„Z
dd„ Zdd„ Z‡ ZS )ÚAppleHelpBuilderz{
Builder that outputs an Apple help book. Requires Mac OS X as it relies
on the ``hiutil`` command line tool.
Ú applehelpzžThe help book is in %(outdir)s.
Note that won't be able to view it unless you put it in ~/Library/Documentation/Help or install it in your application bundle.Fz image/pngz image/gifz
image/jpegz
image/tiffz image/jp2z
image/svg+xmlTc sj t t| ƒ ¡ d| _d| _| jjd kr2ttdƒƒ‚t
| j | jj d ¡| _
t
| j
dd| jjd ¡| _ d S )Nz.htmlzBYou must set applehelp_bundle_id before building Apple Help outputz.helpÚContentsÚ Resourcesz.lproj)Úsuperr ÚinitÚ
out_suffixZ link_suffixÚconfigÚapplehelp_bundle_idr r r ÚjoinÚoutdirÚapplehelp_bundle_nameÚ bundle_pathÚapplehelp_locale)Úself)Ú __class__r r r ` s
zAppleHelpBuilder.initc s. t t| ƒ ¡ | j | j¡ | j | j¡ d S )N)r r Ú
handle_finishZ finish_tasksZadd_taskÚcopy_localized_filesÚbuild_helpbook)r' )r( r r r) s s z AppleHelpBuilder.handle_finishc C sv t | j| jjd ¡}| j}t |¡rrtjt t
dƒƒdd t | jj dg ƒ}t
|||| j| jd t t
dƒ¡ d S )Nz.lprojzcopying localized files... T)Únonlz**/.*)ÚcontextZrendererÚdone)r r" Zconfdirr r& r# ÚisdirÚloggerÚinfor
r r Zexclude_patternsr Z
globalcontextZ templates)r' Z
source_dirZ
target_dirZexcludedr r r r* z s
z%AppleHelpBuilder.copy_localized_filesc
C sŠ t | jd¡}t |d¡}t || jjd ¡}x|||gD ] }t|ƒ q:W | jj| j }| jj| jj dd| jj
d| jj dd| jj d d
d œ }| jj
d k r¨t | jj
¡|d < | jjd k rÌ| jj|d
< | jj|d< | jjd k rä| jj|d< tjttdƒƒdd tt |d¡dƒ}t||ƒ W d Q R X t tdƒ¡ | jj
rÒtjttdƒƒdd y6tt | j| jj
¡t ||d ¡ƒ t tdƒ¡ W nJ tk
rÐ } z*t tdƒt | j| jj
¡|¡ |d = W d d }~X Y nX tjttdƒƒdd t t |d¡d¡*}| t t |ddt | jj ƒdœ ¡ W d Q R X t tdƒ¡ tjttd ƒƒdd | jj d t |d¡|g} | jj!d k r€| "d ¡ | jj#d k r¢| d d | jj# g7 } | jj$d k rÀ| d!| jj$g7 } | jjd k rÞ| d"| jjg7 } | jj%rt td#ƒ¡ t td$ƒd% d&d'„ | D ƒ¡¡ ntyHt&j'| t&j(t&j)d(}
|
*¡ d) } |
j+d)krPt,| ƒ‚nt tdƒ¡ W n* t-k
rŠ t,td*ƒ| d) ƒ‚Y nX | jj.r†tjttd+ƒƒdd | jj/d!| jj.d,g} | | jj07 } | "| j¡ | jj%rt td#ƒ¡ t td-ƒd% d.d'„ | D ƒ¡¡ ntyHt&j'| t&j(t&j)d(}
|
*¡ d) } |
j+d)krJt1| ƒ‚nt tdƒ¡ W n* t-k
r„ t1td*ƒ| d) ƒ‚Y nX d S )/Nr r z.lprojz6.0ZBNDLZhbwrz _access.htmlzsearch.helpindexÚ3F) ZCFBundleDevelopmentRegionZCFBundleIdentifierZ CFBundleInfoDictionaryVersionZCFBundlePackageTypeZCFBundleShortVersionStringZCFBundleSignatureZCFBundleVersionZHPDBookAccessPathZHPDBookIndexPathZ HPDBookTitleZ HPDBookTypeZHPDBookUsesExternalViewerZHPDBookIconPathZHPDBookKBProductZ HPDBookKBURLZHPDBookRemoteURLzwriting Info.plist... T)r, z
Info.plistÚwbr. zcopying icon... z cannot copy icon file %r: %szbuilding access page...Úw)Úquote)ÚtocÚtitlezgenerating help index... z-Cfz-az-mz%sz-sz-lZskippingz0you will need to index this help book with:
%sú c S s g | ]}t |¡‘qS r )Úpipesr5 )Ú.0Úargr r r ú
å s z3AppleHelpBuilder.build_helpbook..)ÚstdoutÚstderrr zCommand not found: %szsigning help book... z-fz/you will need to sign this help book with:
%sc S s g | ]}t |¡‘qS r )r9 r5 )r: r; r r r r< s )2r r" r% r r& r Z
master_docr Úapplehelp_dev_regionr! ÚreleaseÚapplehelp_bundle_versionÚapplehelp_titleÚapplehelp_iconÚbasenameÚapplehelp_kb_urlÚapplehelp_kb_productÚapplehelp_remote_urlr0 r1 r
r ÚopenÚ write_plistr
ZsrcdirÚ ExceptionZwarningÚcodecsÚwriteÚaccess_page_templater Úapplehelp_indexer_pathÚapplehelp_index_anchorsÚappendÚapplehelp_min_term_lengthÚapplehelp_stopwordsÚ applehelp_disable_external_toolsÚ
subprocessÚPopenÚPIPEZSTDOUTZ communicateÚ
returncoder ÚOSErrorÚapplehelp_codesign_identityÚapplehelp_codesign_pathÚapplehelp_codesign_flagsr ) r' Z contents_dirZ
resources_dirZ language_dirÚdr6 Z
info_plistÚfÚerrÚargsÚpÚoutputr r r r+ ˆ s¼
z AppleHelpBuilder.build_helpbook)r r r Ú__doc__Únamer ZepilogZ
copysourceZsupported_image_typesZadd_permalinksZembeddedÚsearchr r) r* r+ Ú
__classcell__r r )r( r r G s
r c C sD | d¡ | t¡ | ddd„ d¡ | dd dt¡ | ddd¡ | d d
d¡ | d d dt¡ | d d
d„ d¡ | dd dt¡ | dd dt¡ | dddt¡ | dd dt¡ | ddd„ d¡ | ddd„ d¡ | ddd„ d¡ | ddd„ d¡ | dd d„ d¡ | d d d¡ | d d d¡ | d!dd ¡ d"d#d#d$œS )%Nzsphinx.builders.htmlr$ c S s
t | jƒS )N)r Úproject)r' r r r Ú s zsetup..r r! r? zen-usrA Ú1rC rF c S s dt | jƒ| jf S )Nz%s-%s)r rf r@ )r' r r r rg # s rE rG rO FrQ rR c S s
| j pdS )NÚen)Úlanguage)r' r r r rg * s r& c S s
| j pdS )Nri )rj )r' r r r rg + s rB c S s
| j d S )Nz Help)rf )r' r r r rg , s rY c S s t dd ¡S )NZCODE_SIGN_IDENTITY)r Úget)r' r r r rg . s r[ c S s t t dd¡¡S )NZOTHER_CODE_SIGN_FLAGSÚ )ÚshlexÚsplitr rk )r' r r r rg 1 s rN z/usr/bin/hiutilrZ z/usr/bin/codesignrS ZbuiltinT)ÚversionZparallel_read_safeZparallel_write_safe)Zsetup_extensionZ add_builderr Zadd_config_valuer )Zappr r r Úsetup s>
rp )-rb Z
__future__r rK r9 Zplistlibrm rT Úosr r Zsphinx.builders.htmlr Z
sphinx.configr Z
sphinx.errorsr Z
sphinx.localer Z sphinx.utilr Zsphinx.util.consoler
Zsphinx.util.fileutilr Zsphinx.util.matchingr Zsphinx.util.osutilr
r r Zsphinx.util.pycompatr Z getLoggerr r0 ÚdumprI ÚAttributeErrorZ
writePlistrM r r r rp r r r r Ú
s8
Q