Merge pull request #327 from freakboy3742/icon-tutorial

Add a tutorial step covering icons
beeware · Apr 30, 2024 · 7a307eb · 7a307eb
2 parents 6fd15b3 + cbe63aa
commit 7a307eb
Show file tree

Hide file tree

Showing 25 changed files with 555 additions and 39 deletions.
diff --git a/docs/index.rst b/docs/index.rst
@@ -91,3 +91,4 @@ Python! <tutorial/tutorial-0>`
     tutorial/tutorial-7
     tutorial/tutorial-8
     tutorial/tutorial-9
+    tutorial/tutorial-10
diff --git a/docs/tutorial/images/linux/tutorial-1.png b/docs/tutorial/images/linux/tutorial-1.png
diff --git a/docs/tutorial/images/linux/tutorial-2.png b/docs/tutorial/images/linux/tutorial-2.png
diff --git a/docs/tutorial/images/linux/tutorial-4.png b/docs/tutorial/images/linux/tutorial-4.png
diff --git a/docs/tutorial/images/linux/tutorial-7.png b/docs/tutorial/images/linux/tutorial-7.png
diff --git a/docs/tutorial/images/macOS/tutorial-1.png b/docs/tutorial/images/macOS/tutorial-1.png
diff --git a/docs/tutorial/images/macOS/tutorial-2.png b/docs/tutorial/images/macOS/tutorial-2.png
diff --git a/docs/tutorial/images/macOS/tutorial-4.png b/docs/tutorial/images/macOS/tutorial-4.png
diff --git a/docs/tutorial/images/macOS/tutorial-7-crash.png b/docs/tutorial/images/macOS/tutorial-7-crash.png
diff --git a/docs/tutorial/images/macOS/tutorial-7.png b/docs/tutorial/images/macOS/tutorial-7.png
diff --git a/docs/tutorial/images/windows/tutorial-1.png b/docs/tutorial/images/windows/tutorial-1.png
diff --git a/docs/tutorial/images/windows/tutorial-2.png b/docs/tutorial/images/windows/tutorial-2.png
diff --git a/docs/tutorial/images/windows/tutorial-4.png b/docs/tutorial/images/windows/tutorial-4.png
diff --git a/docs/tutorial/images/windows/tutorial-7-crash.png b/docs/tutorial/images/windows/tutorial-7-crash.png
diff --git a/docs/tutorial/images/windows/tutorial-7.png b/docs/tutorial/images/windows/tutorial-7.png
diff --git a/docs/tutorial/resources/icon.png b/docs/tutorial/resources/icon.png
diff --git a/docs/tutorial/resources/icons.zip b/docs/tutorial/resources/icons.zip
diff --git a/docs/tutorial/tutorial-0.rst b/docs/tutorial/tutorial-0.rst
@@ -22,8 +22,15 @@ The first thing we'll need is a working Python interpreter.
 
       $ python3 --version
 
-    If Python is installed, you'll see its version number. Otherwise, you'll
-    be prompted to install the command line developer tools.
+    If Python is installed, you'll see its version number. Otherwise, you'll be
+    prompted to install the command line developer tools.
+
+    You should ensure that you are using Python 3.8 or newer. If it isn't,
+    you'll need to upgrade your Python install. You can get the official
+    installer from `the Python website <https://www.python.org/downloads>`_. You
+    can use any stable version of Python from 3.8 onward. We'd advise avoiding
+    alphas, betas, and release candidates unless you *really* know what you're
+    doing.
 
   .. group-tab:: Linux
 
@@ -95,19 +102,19 @@ Next, install the additional dependencies needed for your operating system:
     .. code-block:: console
 
       $ sudo apt update
-      $ sudo apt install build-essential git pkg-config python3-dev python3-venv libgirepository1.0-dev libcairo2-dev gir1.2-webkit2-4.0 libcanberra-gtk3-module
+      $ sudo apt install build-essential git pkg-config python3-dev python3-venv libgirepository1.0-dev libcairo2-dev libcanberra-gtk3-module
 
     **Fedora**
 
     .. code-block:: console
 
-      $ sudo dnf install git pkg-config rpm-build python3-devel gobject-introspection-devel cairo-gobject-devel webkit2gtk3 libcanberra-gtk3
+      $ sudo dnf install git pkg-config rpm-build python3-devel gobject-introspection-devel cairo-gobject-devel libcanberra-gtk3
 
     **Arch, Manjaro**
 
     .. code-block:: console
 
-      $ sudo pacman -Syu base-devel git pkgconf python3 gobject-introspection cairo webkit2gtk libcanberra
+      $ sudo pacman -Syu base-devel git pkgconf python3 gobject-introspection cairo libcanberra
 
   .. group-tab:: Windows
 

diff --git a/docs/tutorial/tutorial-1.rst b/docs/tutorial/tutorial-1.rst
@@ -206,16 +206,19 @@ This should open a GUI window:
   .. group-tab:: macOS
 
     .. image:: images/macOS/tutorial-1.png
+       :align: center
        :alt: Hello World Tutorial 1 window, on macOS
 
   .. group-tab:: Linux
 
     .. image:: images/linux/tutorial-1.png
+       :align: center
        :alt: Hello World Tutorial 1 window, on Linux
 
   .. group-tab:: Windows
 
     .. image:: images/windows/tutorial-1.png
+       :align: center
        :alt: Hello World Tutorial 1 window, on Windows
 
 Press the close button (or select Quit from the application's menu), and you're