26.5. IDLE¶
+IDLE¶
Source code: Lib/idlelib/
IDLE is Python’s Integrated Development and Learning Environment.
@@ -107,7 +120,7 @@ of global and local namespaces26.5.1. Menus¶
+Menus¶
IDLE has two main window types, the Shell window and the Editor window. It is possible to have multiple editor windows simultaneously. Output windows, such as used for Edit / Find in Files, are a subtype of edit window. They currently @@ -116,7 +129,7 @@ context menu.
IDLE’s menus dynamically change based on which window is currently selected. Each menu documented below indicates which window type it is associated with.
26.5.3. Startup and code execution¶
+Startup and code execution¶
Upon startup with the -s option, IDLE will execute the file referenced by
the environment variables IDLESTARTUP or PYTHONSTARTUP.
IDLE first checks for IDLESTARTUP; if IDLESTARTUP is present the file
@@ -510,7 +523,7 @@ looked for in the user’s home directory. Statements in this file will be
executed in the Tk namespace, so this file is not useful for importing
functions to be used from IDLE’s Python shell.
26.5.3.1. Command line usage¶
+Command line usage¶
idle.py [-c command] [-d] [-e] [-h] [-i] [-r file] [-s] [-t title] [-] [arg] ...
-c command run command in the shell window
@@ -535,7 +548,7 @@ set in the Options dialog.
26.5.3.2. Startup failure¶
+Startup failure¶
IDLE uses a socket to communicate between the IDLE GUI process and the user code execution process. A connection must be established whenever the Shell starts or restarts. (The latter is indicated by a divider line that says @@ -571,7 +584,7 @@ be to delete one or more of the configuration files.
starting from a console (python -m idlelib) and see if a message appears.
26.5.3.3. IDLE-console differences¶
+IDLE-console differences¶
With rare exceptions, the result of executing Python code with IDLE is intended to be the same as executing the same code in a console window. However, the different interface and operation occasionally affect @@ -589,7 +602,7 @@ Some consoles only work with a single physical line at a time. IDLE uses defined for each statement.
26.5.3.4. Developing tkinter applications¶
+Developing tkinter applications¶
IDLE is intentionally different from standard Python in order to
facilitate development of tkinter programs. Enter import tkinter as tk;
root = tk.Tk() in standard Python and nothing appears. Enter the same
@@ -609,7 +622,7 @@ interact with the live application. One just has to remember to
re-enable the mainloop call when running in standard Python.
26.5.3.5. Running without a subprocess¶
+Running without a subprocess¶
By default, IDLE executes user code in a separate subprocess via a socket, which uses the internal loopback interface. This connection is not externally visible and no data is sent to or received from the Internet. @@ -635,9 +648,9 @@ with the default subprocess if at all possible.
26.5.4. Help and preferences¶
+Help and preferences¶
26.5.4.1. Additional help sources¶
+Additional help sources¶
IDLE includes a help menu entry called “Python Docs” that will open the extensive sources of help, including tutorials, available at docs.python.org. Selected URLs can be added or removed from the help menu at any time using the @@ -645,14 +658,14 @@ Configure IDLE dialog. See the IDLE help option in the help menu of IDLE for more information.
26.5.4.2. Setting preferences¶
+Setting preferences¶
The font preferences, highlighting, keys, and general preferences can be changed via Configure IDLE on the Option menu. Keys can be user defined; IDLE ships with four built-in key sets. In addition, a user can create a custom key set in the Configure IDLE dialog under the keys tab.
26.5.4.3. Extensions¶
+Extensions¶
IDLE contains an extension facility. Preferences for extensions can be changed with the Extensions tab of the preferences dialog. See the beginning of config-extensions.def in the idlelib directory for further @@ -668,42 +681,42 @@ also used for testing.
Table Of Contents
+Table of Contents
-
-
- 26.5. IDLE
-
-
- 26.5.1. Menus
-
-
- 26.5.1.1. File menu (Shell and Editor) -
- 26.5.1.2. Edit menu (Shell and Editor) -
- 26.5.1.3. Format menu (Editor window only) -
- 26.5.1.4. Run menu (Editor window only) -
- 26.5.1.5. Shell menu (Shell window only) -
- 26.5.1.6. Debug menu (Shell window only) -
- 26.5.1.7. Options menu (Shell and Editor) -
- 26.5.1.8. Window menu (Shell and Editor) -
- 26.5.1.9. Help menu (Shell and Editor) -
- 26.5.1.10. Context Menus +
- IDLE
-
+
- Menus -
- 26.5.2. Editing and navigation
-
-
- 26.5.2.1. Automatic indentation -
- 26.5.2.2. Completions -
- 26.5.2.3. Calltips -
- 26.5.2.4. Python Shell window -
- 26.5.2.5. Text colors +
- Editing and navigation -
- 26.5.3. Startup and code execution
-
-
- 26.5.3.1. Command line usage -
- 26.5.3.2. Startup failure -
- 26.5.3.3. IDLE-console differences -
- 26.5.3.4. Developing tkinter applications -
- 26.5.3.5. Running without a subprocess +
- Startup and code execution -
- 26.5.4. Help and preferences
-
-
- 26.5.4.1. Additional help sources -
- 26.5.4.2. Setting preferences -
- 26.5.4.3. Extensions +
- Help and preferences
Previous topic
26.4.
+ title="previous chapter">tkinter.scrolledtext— Scrolled Text Widgettkinter.scrolledtext— Scrolled Text WidgetNext topic
+ title="next chapter">Other Graphical User Interface Packages diff --git a/Lib/idlelib/help.py b/Lib/idlelib/help.py index 21b5ea5a816..ae991ee8bae 100644 --- a/Lib/idlelib/help.py +++ b/Lib/idlelib/help.py @@ -126,7 +126,10 @@ class HelpParser(HTMLParser): if tag in ['h1', 'h2', 'h3']: self.indent(0) # clear tag, reset indent if self.show: - self.toc.append((self.header, self.text.index('insert'))) + indent = (' ' if tag == 'h3' else + ' ' if tag == 'h2' else + '') + self.toc.append((indent+self.header, self.text.index('insert'))) elif tag in ['span', 'em']: self.chartags = '' elif tag == 'a': @@ -142,11 +145,15 @@ class HelpParser(HTMLParser): if self.show and not self.hdrlink: d = data if self.pre else data.replace('\n', ' ') if self.tags == 'h1': - self.hprefix = d[0:d.index(' ')] - if self.tags in ['h1', 'h2', 'h3'] and self.hprefix != '': - if d[0:len(self.hprefix)] == self.hprefix: - d = d[len(self.hprefix):].strip() - self.header += d + try: + self.hprefix = d[0:d.index(' ')] + except ValueError: + self.hprefix = '' + if self.tags in ['h1', 'h2', 'h3']: + if (self.hprefix != '' and + d[0:len(self.hprefix)] == self.hprefix): + d = d[len(self.hprefix):] + self.header += d.strip() self.text.insert('end', d, (self.tags, self.chartags)) diff --git a/Misc/NEWS.d/next/IDLE/2018-10-28-00-08-42.bpo-35087.G7gx2-.rst b/Misc/NEWS.d/next/IDLE/2018-10-28-00-08-42.bpo-35087.G7gx2-.rst new file mode 100644 index 00000000000..0fd26699a96 --- /dev/null +++ b/Misc/NEWS.d/next/IDLE/2018-10-28-00-08-42.bpo-35087.G7gx2-.rst @@ -0,0 +1,2 @@ +Update idlelib help files for the current doc build. The main change is the +elimination of chapter-section numbers.
- 26.5.1. Menus