Your IP : 3.144.6.236
�
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
<to be moved here from aboutDialog.py>
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)�abspath�dirname�isdir�isfile�join)�Tk�Toplevel�Frame�Text� Scrollbar�Menu�
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)�
HelpParserz�Render 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__�text�tags�chartags�show�hdrlink�level�pre�hprefix� nested_dl�
simplelist�toc�header)�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 r�d | _ q�n,| d k r�| j r�d n d } n| d k r�| j s�d
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 r�d | _ | 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
sphinxsidebarF�p�firstz
�spanr Zversionmodified�em�ul�olZsimpler# �
Zdlr Zliz
* z
* Zdt�dd�end�preblock�aZ
headerlink�h1�h2�h3N)r- r. ���)r5 r6 )
r r �findr r' r r r r �insertr r r )r �tagZattrsZclass_r3 �v�sr! 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 �len�stripr r r9 r )r �data�dr! r! r" � handle_data� s ! ""zHelpParser.handle_dataN) �__name__�
__module__� __qualname__�__doc__r r' r= r@ rG 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 <d6 S)9z'Configure tags and feed file to parser.�mainZ EditorWindow�width�type�intZheight� � ZwrapZwordZhighlightthicknessr Zpadx� Z borderwidthZ
TkDefaultFontZarialZ helveticaZ TkFixedFontZmonacoZcourier� r r, Zitalicr4 � Zboldr5 � r6 � r �
backgroundz#f6f6ffr2 �
Zlmargin1� r# ZreliefZsolidz#eeffcc�l1Zlmargin2�l2�2 �l3�K �l4�d �encodingzutf-8NZdisabled�state) r Z GetOptionr r �findfontZ
tag_configurer �parser�open�readZfeed) r �parent�filenameZuwideZuhighZ
normalfontZ fixedfont�f�contentsr! r! r" r � s0 zHelpText.__init__c C s� x� | D]� } | j � d d � t j d | � D� k rd t j d | d d d | � } | j � d S| j � d d � t j d | � D� k r | Sq Wd S)
z4Return name of first font family derived from names.c s s | ] } | j � Vq d S)N)�lower)�.0�xr! r! r" � <genexpr>� s z$HelpText.findfont.<locals>.<genexpr>�root�name�existsTZfamilyc s s | ] } | j � Vq d S)N)rl )rm rn r! r! r" ro � s N)rl �tkfont�namesZFontZactualZfamilies)r rt rq r r! r! r" rd � s
+ zHelpText.findfontN)rH rI rJ rK r rd r! r! r! r" rL � s rL 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 <t | d | j �} | j | d <| j d d d �| j d d d �| j | � j d d d d d d
� | j d d d d d d � | j d d d d d d
� d S)NrX �commandZyscrollcommandr �weightr# �column�row�stickyZnw�nsew� �ns)
r
r rL r �yview�setZ rowconfigureZcolumnconfigure�toc_menu�grid)r rh ri r Zscrollr! r! r" r � s
% zHelpFrame.__init__c st t | d d �} t | d d �} x? � j j D]1 \ } } | j d | d | � f d d � � q1 W| | d <| S)
z+Create table of contents as drop-down menu.r ZTOCZtearoffFZlabelrv c s
� j | � S)N)r~ )�dex)r r! r" �<lambda>� s z$HelpFrame.toc_menu.<locals>.<lambda>Zmenu)r r
re r Z add_command)r r r ZdropZlblr� r! )r r" r� � s )
zHelpFrame.toc_menuN)rH rI rJ rK r r� r! r! r! r" ru � s ru 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_WINDOWrx r ry rz r{ rw r# ) r r Zwm_titleZprotocolZdestroyru r� Zgrid_columnconfigureZgrid_rowconfigure)r rh ri �titler! r! r" r � s
%zHelpWindow.__init__N)rH rI rJ rK 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.html�rb�wbs
Nz idle.html copied to help.html)r r r �__file__rf �write�rstrip�print)�srcZdstZinn�out�liner! 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� )rh ri r! r! r" �
show_idlehelp� s r� �__main__)�runN) rK Z html.parserr Zos.pathr r r r r Ztkinterr r r
r r r
r r rs Zidlelib.configHandlerr Zuse_ttkZ tkinter.ttkr rL ru r� r� r� rH Zidlelib.idle_test.htestr� r! r! r! r" �<module> s" (4m*