B
\ 2 @ s d Z ddlmZ ddlZddlZddlmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ eeZdZdZ dZ dZ d Z dddddddddd d d d d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0 Z!d7d1d2Z"G d3d4 d4e
Z#d5d6 Z$dS )8a
sphinx.builders.htmlhelp
~~~~~~~~~~~~~~~~~~~~~~~~
Build HTML help support files.
Parts adapted from Python's Doc/tools/prechm.py.
:copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
)print_functionN)path)nodes)PY3)addnodes)StandaloneHTMLBuilder) IndexEntries)__)logging)
make_filename)
htmlescapea [OPTIONS]
Binary TOC=No
Binary Index=No
Compiled file=%(outname)s.chm
Contents file=%(outname)s.hhc
Default Window=%(outname)s
Default topic=%(master_doc)s
Display compile progress=No
Full text search stop list file=%(outname)s.stp
Full-text search=Yes
Index file=%(outname)s.hhk
Language=%(lcid)#x
Title=%(title)s
[WINDOWS]
%(outname)s="%(title)s","%(outname)s.hhc","%(outname)s.hhk","%(master_doc)s","%(master_doc)s",,,,,0x63520,220,0x10384e,[0,0,1024,768],,,,,,,0
[FILES]
aB
z
zn
z
a and are as at
be but by
for
if in into is it
near no not
of on or
such
that the their then there these they this to
was will with
)i cp1252)i cp1250)i r
)i r
)i r
)i
r
)i% cp1257)i) cp1256)i r
)i r
)i r )i r )i r
)i cp932)i cp949)i' r )i& r )i r
)i r
)i r )i r
)i cp1251)i r )i$ r )i r
)i cp1254)i" r )i cp936)i cp950) ZcaZcsZdaZdeZenZesZetZfaZfifrZhrZhuitZjaZkoltZlvnlZno_NBZplZpt_BRZruZskZslZsvZtrZuk_UAZzh_CNZzh_TWc C s& |dkr t }t| |} | dd} | S )a5
chm_htmlescape() is a wrapper of html.escape().
.hhc/.hhk files don't recognize hex escaping, we need convert
hex escaping to decimal escaping. for example: ``'`` -> ``'``
html.escape() may generates a hex escaping ``'`` for single
quote ``'``, this wrapper fixes this.
Nz'z')r r replace)sZquote r 7lib/python3.7/site-packages/sphinx/builders/htmlhelp.pychm_htmlescape s
r c @ sp e Zd ZdZdZedZdZdddgZdZ dZ
dZ d Z d
Z
d d ZdddZdd Zdd Zdd Zdd ZdS )HTMLHelpBuilderz
Builder that also outputs Windows HTML help project, contents and
index files. Adapted from the original Doc/tools/prechm.py.
ZhtmlhelpzDYou can now run HTML Help Workshop with the .htp file in %(outdir)s.Fz image/pngz image/gifz
image/jpegTi r
c C s< t | d| _d| _t| jj}|d k r8|\| _| _ d S )Nz.html)
r init
out_suffixZ link_suffix chm_localesgetconfigZlanguagelcidencoding)selfZlocaler r r r! s
zHTMLHelpBuilder.initwc C s t t|||| jdS )Nxmlcharrefreplace)codecsopenr joinr' )r( outdirbasenamemoder r r open_file s zHTMLHelpBuilder.open_filec C s | j |d< d S )Nr' )r' )r( ZpagenameZ templatenameZctxZ event_argr r r update_page_context s z#HTMLHelpBuilder.update_page_contextc C s | | j| jj d S )N) build_hhxr. r% htmlhelp_basename)r( r r r
handle_finish s z HTMLHelpBuilder.handle_finishc C sF x2| tjD ]"}|dd krd|krd|d< qW t| || d S )NZinternalrefuriZ_blanktarget)traverser referencer$ r write_doc)r( ZdocnameZdoctreenoder r r r: s zHTMLHelpBuilder.write_docc s t td | ||d $ x ttD ]}t| d q*W W d Q R X t td | ||d t|| j j
| j j | j j | j
| j j| j d |tjs|tj7 }t|}xt|D ]\}}}| | |t|d}xRt|D ]F} |r| dr | d rtt|| |d tjd
d qW qW W d Q R X t td | ||d t d
t| j j | j j| j f x4| j D ]*\}
} } }
d
t| j d|
f qW | j j | j j| dd}d fdd dd }x |!|D ]}| qW t" W d Q R X t td t#| j $| }| ||d b d fddx8|D ]0\}}x$|D ] \}\}}}||| qW qW d W d Q R X d S ) Nzdumping stopword list...z.stp)filezwriting project file...z.hhp)outnametitleversionprojectr&
master_docZ_staticz.jsz.html\zwriting TOC file...z.hhcz
z%s.htmlF)Zprune_toctreesr c s t | tjr0 d x| D ]}|| q W nt | tjrf| d }t| d} t||f nrt | tjr|dkr d x| D ]}||d qW |dkr؈ d n$t | t j
rx| D ]}|| qW d S )Nz
r6 Tr z
z
)
isinstancer Z list_itemwriter9 r Zastextobject_sitemapZ bullet_listr compact_paragraph)r; ZullevelZsubnodelinkr> )f write_tocr r rJ # s$
z,HTMLHelpBuilder.build_hhx..write_tocc S s t | tjod| kS )NZtoctree)rD r rG )r; r r r istoctree8 s z,HTMLHelpBuilder.build_hhx..istoctreezwriting index file...z.hhkz
c s fdd}t | d} d |d| t|dkrB|d| nZt|dkrb|d |d d n:x8t|D ],\}}|d
d ||d f |d |d qlW d |r d
x |D ]}|d |d g qW d d S )Nc s d| |f } | d S )Nz!
)rE )namevalueitem)rI r r write_paramG s zCHTMLHelpBuilder.build_hhx..write_index..write_paramTz"
z
z
)r rE len enumerate)r> refssubitemsrO irefZsubitem)rI write_indexr r rW E s"
z.HTMLHelpBuilder.build_hhx..write_indexz
)r )%loggerinfor r1 sorted stopwordsprintrE project_templater% Z
html_titler? r@ r& rA r" endswithosseprQ walksort
startswithr r- r contents_headerrF Zhtml_short_titleZdomain_indicesZ localnameenvZget_and_resolve_doctreer8 contents_footerr Z create_index)r( r. r= ZwordZolenrootdirsfilesZ staticdirfnZ indexnameZindexclsZcontentZcollapseZtocdocrK r; indexkeygroupr> rS rT Zkey_r )rI rW rJ r r3 sb
zHTMLHelpBuilder.build_hhxN)r) )__name__
__module__ __qualname____doc__rL r ZepilogZ
copysourceZsupported_image_typesZadd_permalinksZembeddedsearchr& r' r! r1 r2 r5 r: r3 r r r r r s
r c C s2 | d | t | ddd d ddddS )Nzsphinx.builders.htmlr4 c S s
t | jS )N)r r@ )r( r r r h s zsetup..ZbuiltinT)r? Zparallel_read_safeZparallel_write_safe)Zsetup_extensionZ add_builderr Zadd_config_value)Zappr r r setupc s
rt )N)%rq Z
__future__r r+ r_ r Zdocutilsr Zsixr Zsphinxr Zsphinx.builders.htmlr Z(sphinx.environment.adapters.indexentriesr Z
sphinx.localer Z sphinx.utilr
Zsphinx.util.osutilr Zsphinx.util.pycompatr Z getLoggerrn rX r] rd rf rF splitr[ r# r r rt r r r r sh
9
&