e f% @ sN d Z d d l m Z d d l m Z m Z m Z m Z m Z d d l m
Z
m Z m Z m
Z
m Z m Z m Z d d l m Z d d l m Z d Z e r d d l m Z n Gd d
d
e Z Gd d d e
Z Gd
d d e Z Gd d d e Z d d Z d d Z e d k rJd d l m Z e e n d S)a help.py: Implement the Idle help menu.
Contents are subject to revision at any time, without notice.
Help => About IDLE: diplay About Idle dialog
Help => IDLE Help: Display help.html with proper formatting.
Doc/library/idle.rst (Sphinx)=> Doc/build/html/library/idle.html
(help.copy_strip)=> Lib/idlelib/help.html
HelpParser - Parse help.html and and render to tk Text.
HelpText - Display formatted help.html.
HelpFrame - Contain text, scrollbar, and table-of-contents.
(This will be needed for display in a future tabbed window.)
HelpWindow - Display HelpFrame in a standalone window.
copy_strip - Copy idle.html to help.html, rstripping each line.
show_idlehelp - Create HelpWindow. Called in EditorWindow.help_dialog.
)
HTMLParser)abspathdirnameisdirisfilejoin)TkToplevelFrameText ScrollbarMenu
Menubutton)font)idleConfF)r c @ sU e Z d Z d Z d d Z d d d Z d d Z d d
Z d d Z d
S)
HelpParserzRender help.html into a text widget.
The overridden handle_xyz methods handle a subset of html tags.
The supplied text should have the needed tag configurations.
The behavior for unsupported tags, such as table, is undefined.
c C s t j | d d | | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _
d | _ g | _ d | _
d S)NZconvert_charrefsT Fr )r __init__texttagschartagsshowhdrlinklevelprehprefix nested_dl
simplelisttocheader)selfr r! 1/opt/alt/python34/lib64/python3.4/idlelib/help.pyr 1 s zHelpParser.__init__ c C s> | j | 7_ | j d k r$ d n d t | j | _ d S)Nr r l)r strr )r amtr! r! r" indent@ s zHelpParser.indentc C s d } x) | D]! \ } } | d k r
| } q
q
Wd } | d k r\ | d k r\ d | _ nD| d k r | d k r d | _ n | d k r | d k r d
} n| d k r | d k r d | _ n| d k r | d
k r d | _ n| d k rd | _ n| d# k rJ| j d d$ k r4d } d | _ n d | _ | j nV| d k rt| j d k rd | _ qn,| d k r| j rd n d } n| d k r| j sd
n d } d | _ n | d k r| j d } n | d k r$d | _ | j r| j j d d
n d | _
n| | d k rH| d k rHd | _ nX | d k r`| | _
n@ | d% k r| j rd | _ | j j d d
n | | _
n | j r| j j d | | j
| j f n d" S)&z Handle starttags in help.html.r classZdivZsectionTZ
sphinxsidebarFpfirstz
spanr ZversionmodifiedemulolZsimpler#
Zdlr Zliz
* z
* ZdtddendpreblockaZ
headerlinkh1h2h3N)r- r. )r5 r6 )
r r findr r' r r r r insertr r r )r tagattrsZclass_r3 vsr! r! r" handle_starttagD sd
zHelpParser.handle_starttagc C s | d k rM | j d | j r | j j | j | j j d f q np | d k re d | _ nX | d k r} d
| _ n@ | d k r d
| _ d | _
n | d k r | j d d n d S)z Handle endtags in help.html.r4 r5 r6 r r9 r+ r, r r3 Fr r- r0 r. r& r# N)zh1zh2zh3)zspanzem)zulzddzolr7 ) r' r r appendr r indexr r r r )r r: r! r! r"
handle_endtagz s
+ zHelpParser.handle_endtagc C s | j r | j r | j r" | n | j d d } | j d k rb | d | j d | _ n | j d
k r | j d k r | d t | j | j k r | t | j d j } n | j | 7_ n | j
j d | | j | j f n d S) z"Handle date segments in help.html.r/ r4 r r5 r6 r Nr1 )zh1zh2zh3)
r r r replacer r@ r lenstripr r r9 r )r datadr! r! r" handle_data s ! ""zHelpParser.handle_dataN) __name__
__module__ __qualname____doc__r r' r> rA rH r! r! r! r" r * s 6 r c @ s. e Z d Z d Z d d Z d d Z d S)HelpTextzDisplay help.html.c C s0 t j d d d d d } t j d d d d d } d | d } t j | | d d
d d d
d d d d | d | | j d d d g } | j d d d g } | d f | d <| j d d | d d f | j d d | d d f | j d d | d d f | j d d | d d f | j d! d | d f d" d# | j d$ d | d% f d& d' d d( d) d* d" d+ | j d, d& d' d- d' | j d. d& d/ d- d/ | j d0 d& d1 d- d1 | j d2 d& d3 d- d3 t | | _ t | d4 d5 } | j } Wd6 QX| j j
| d7 | d8 s z$HelpText.findfont..rootnameexistsTZfamilyc s s | ] } | j Vq d S)N)rm )rn ro r! r! r" rp s N)rm tkfontnamesZFontZactualZfamilies)r ru rr r r! r! r" re s
+ zHelpText.findfontN)rI rJ rK rL r re r! r! r! r" rM s rM c @ s. e Z d Z d Z d d Z d d Z d S) HelpFramez&Display html text, scrollbar, and toc.c C s t j | | t | | } | d | d s z$HelpFrame.toc_menu..Zmenu)r r
rf r Z add_command)r r r ZdropZlblr r! )r r" r s )
zHelpFrame.toc_menuN)rI rJ rK rL r r r! r! r! r" rv s rv c @ s" e Z d Z d Z d d Z d S)
HelpWindowz!Display frame with rendered html.c C s t j | | | j | | j d | j t | | j d d d d d d | j d d d | j d d d d S) NZWM_DELETE_WINDOWry r rz r{ r| rx r# ) r r Zwm_titleZprotocolZdestroyrv r Zgrid_columnconfigureZgrid_rowconfigure)r ri rj titler! r! r" r s
%zHelpWindow.__init__N)rI rJ rK rL r r! r! r! r" r s r c C s t t t t t t d d d d d } t t t t d } t | d G } t | d / } x% | D] } | j | j d qy WWd
QXWd
QXt d d
S) zCCopy idle.html to idlelib/help.html, stripping trailing whitespace.ZDocZbuildZhtmlZlibraryz idle.htmlz help.htmlrbwbs
Nz idle.html copied to help.html)r r r __file__rg writerstripprint)srcZdstZinnoutliner! r! r"
copy_strip s
'r c C s? t t t t d } t | s+ d St | | d d S)z7Create HelpWindow; called from Idle Help event handler.z help.htmlNz IDLE Help)r r r r r r )ri rj r! r! r"
show_idlehelp s r __main__)runN) rL Z html.parserr Zos.pathr r r r r Ztkinterr r r
r r r
r r rt Zidlelib.configHandlerr Zuse_ttkZ tkinter.ttkr rM rv r r r rI Zidlelib.idle_test.htestr r! r! r! r" s" (4m*