bpo-42560: rework external references in Tkinter docs (GH-27838)

- reorganized from two sections (tkinter vs. tcl/tk) into three (tkinter, tcl/tk, and books)
- main (recommended) tkinter docs have one tutorial (tkdocs) and one reference (shipman), added better descriptions
- dropped link to Tkinter page on wiki (suggestion by E. Paine; outdated, most material already linked to from python.org)
- replaced Tcl/Tk recent man pages and core dev home with single link to main Tcl/Tk page (which holds both of these)
- updated Modern Tkinter link to book page on TkDocs site (was Amazon link to old version), dropped description
- replaced Grayson book by Moore book (newer, covers ttk)
- changed Ousterhout ref to second edition, covers ttk
- dropped link to Welch book (old)
This commit is contained in:
Mark Roseman 2021-08-22 11:34:15 -07:00 committed by GitHub
parent b1db308c61
commit d1049d1d6b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -32,44 +32,34 @@ details that are unchanged.
.. seealso:: .. seealso::
Tkinter documentation: * `TkDocs <http://tkdocs.com/>`_
Extensive tutorial on creating user interfaces with Tkinter. Explains key concepts,
and illustrates recommended approaches using the modern API.
`Python Tkinter Resources <https://wiki.python.org/moin/TkInter>`_ * `Tkinter 8.5 reference: a GUI for Python <https://www.tkdocs.com/shipman/>`_
The Python Tkinter Topic Guide provides a great deal of information on using Tk Reference documentation for Tkinter 8.5 detailing available classes, methods, and options.
from Python and links to other sources of information on Tk.
`TKDocs <http://www.tkdocs.com/>`_ Tcl/Tk Resources:
Extensive tutorial plus friendlier widget pages for some of the widgets.
`Tkinter 8.5 reference: a GUI for Python <https://www.tkdocs.com/shipman/>`_ * `Tk commands <https://www.tcl.tk/man/tcl8.6/TkCmd/contents.htm>`_
On-line reference material. Comprehensive reference to each of the underlying Tcl/Tk commands used by Tkinter.
`Programming Python <http://learning-python.com/about-pp4e.html>`_ * `Tcl/Tk Home Page <https://www.tcl.tk>`_
Book by Mark Lutz, has excellent coverage of Tkinter. Additional documentation, and links to Tcl/Tk core development.
`Modern Tkinter for Busy Python Developers <https://www.amazon.com/Modern-Tkinter-Python-Developers-ebook/dp/B0071QDNLO/>`_ Books:
Book by Mark Roseman about building attractive and modern graphical user interfaces with Python and Tkinter.
`Python and Tkinter Programming <https://www.manning.com/books/python-and-tkinter-programming>`_ * `Modern Tkinter for Busy Python Developers <https://tkdocs.com/book.html>`_
Book by John Grayson (ISBN 1-884777-81-3). By Mark Roseman. (ISBN 978-1999149567)
Tcl/Tk documentation: * `Python and Tkinter Programming <https://www.packtpub.com/product/python-gui-programming-with-tkinter/9781788835886>`_
By Alan Moore. (ISBN 978-1788835886)
`Tk commands <https://www.tcl.tk/man/tcl8.6/TkCmd/contents.htm>`_ * `Programming Python <http://learning-python.com/about-pp4e.html>`_
Most commands are available as :mod:`tkinter` or :mod:`tkinter.ttk` classes. By Mark Lutz; has excellent coverage of Tkinter. (ISBN 978-0596158101)
Change '8.6' to match the version of your Tcl/Tk installation.
`Tcl/Tk recent man pages <https://www.tcl.tk/doc/>`_ * `Tcl and the Tk Toolkit (2nd edition) <https://www.amazon.com/exec/obidos/ASIN/032133633X>`_
Recent Tcl/Tk manuals on www.tcl.tk. By John Ousterhout, inventor of Tcl/Tk, and Ken Jones; does not cover Tkinter. (ISBN 978-0321336330)
`ActiveState Tcl Home Page <https://tcl.tk>`_
The Tk/Tcl development is largely taking place at ActiveState.
`Tcl and the Tk Toolkit <https://www.amazon.com/exec/obidos/ASIN/020163337X>`_
Book by John Ousterhout, the inventor of Tcl.
`Practical Programming in Tcl and Tk <http://www.beedub.com/book/>`_
Brent Welch's encyclopedic book.
Architecture Architecture