Add tutorial for creating publication-ready images with draw_tree

Makefile.am

@@ -101,7 +101,6 @@ EXTRA_DIST = \
 	src/gui/bitmaps/zoom1.xpm \
 	src/gui/bitmaps/gambitrc.rc \
 	contrib/games/2s2x2x2.efg \
-	contrib/games/2smp.efg \
 	contrib/games/2x2x2.efg \
 	contrib/games/4cards.efg \
 	contrib/games/artist1.efg \
@@ -236,6 +235,7 @@ EXTRA_DIST = \
 	contrib/games/yamamoto.nfg \
 	contrib/games/zero.nfg \
 	src/README.rst \
+	catalog/2smp.efg \
 	catalog/myerson1991/fig4_2.efg \
 	catalog/selten1975/fig1.efg \
 	catalog/selten1975/fig2.efg \

doc/pygambit.rst

@@ -8,8 +8,9 @@ See installation instructions in the :ref:`install` section.
 
 
 For newcomers to Gambit, we recommend reading through the PyGambit tutorials, which demonstrate the API's key capabilities for analyzing and solving games.
-These tutorials are available to be run interactively as Jupyter notebooks, see :ref:`local_tutorials`.
-All of the tutorials assume a basic knowledge of programming in Python.
+All of these tutorials assume a basic knowledge of programming in Python.
+
+You can run the tutorials interactively as Jupyter notebooks, see :ref:`local_tutorials`.
 
 New user tutorials
 ------------------
@@ -20,10 +21,10 @@ They are numbered in the order they should be read.
 .. toctree::
    :maxdepth: 2
 
-   tutorials/running_locally
    tutorials/01_quickstart
    tutorials/02_extensive_form
    tutorials/03_stripped_down_poker
+   tutorials/04_creating_images
 
 Advanced user tutorials
 -----------------------

doc/tutorials/01_quickstart.ipynb

@@ -311,7 +311,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "24f36b0d",
+   "id": "3dfbf327",
    "metadata": {},
    "source": [
     "Saving and reading strategic form games to and from file\n",
@@ -320,35 +320,18 @@
     "You can use Gambit to save games to, and read from files.\n",
     "The specific format depends on whether the game is normal or extensive-form.\n",
     "\n",
-    "Here we'll save the Prisoner's Dilemma (Normal-form) to the `.nfg` format."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "f58eaa77",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# g.to_nfg(\"prisoners_dilemma.nfg\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "e373be1e",
-   "metadata": {},
-   "source": [
-    "You can easily restore the game object from file like so:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "4119a2ac",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# gbt.read_nfg(\"prisoners_dilemma.nfg\")"
+    "Here we'll save the Prisoner's Dilemma (Normal-form) to the `.nfg` format.\n",
+    "Run these lines of code in new code cells if you're running the tutorial locally:\n",
+    "\n",
+    "```python\n",
+    "g.to_nfg(\"prisoners_dilemma.nfg\")\n",
+    "```\n",
+    "\n",
+    "You can easily restore the game object from file like so:\n",
+    "\n",
+    "```python\n",
+    "gbt.read_nfg(\"prisoners_dilemma.nfg\")\n",
+    "```"
    ]
   }
  ],

doc/tutorials/02_extensive_form.ipynb

@@ -314,67 +314,17 @@
     "The specific format depends on whether the game is normal or extensive-form.\n",
     "\n",
     "Here we'll save the Trust game (extensive-form) to the `.efg` format.\n",
-    "Uncomment these lines of code if you're running the tutorial locally:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "37c51152",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# g.to_efg(\"trust_game.efg\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "0eb31525",
-   "metadata": {},
-   "source": [
-    "You can easily restore the game object from file like so:"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "0d86a750",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# gbt.read_efg(\"trust_game.efg\")"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "182f2424-274e-4044-84ff-3323cd70ec68",
-   "metadata": {},
-   "source": [
-    "You can also use the `draw_tree` package to save the game in the `.ef` format which encodes layout information.\n",
-    "This can in turn be used to render the image for use in publications, for example as a `.png` (there are also `.pdf` and `.tex` options, see [draw_tree](https://github.com/gambitproject/draw_tree)):"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "1bab777f-8a0b-4f1e-9c0c-270690288243",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# from draw_tree import generate_png\n",
-    "# draw_tree(g, save_to=\"trust_game.ef\")\n",
-    "# trust_game_png = generate_png(\"trust_game.ef\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "2b715221-e427-4092-ad2f-9f4f2b548fa4",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# from IPython.display import Image\n",
-    "# Image(trust_game_png)"
+    "Run these lines of code in new code cells if you're running the tutorial locally:\n",
+    "\n",
+    "```python\n",
+    "g.to_efg(\"trust_game.efg\")\n",
+    "```\n",
+    "\n",
+    "You can easily restore the game object from file like so:\n",
+    "\n",
+    "```python\n",
+    "gbt.read_efg(\"trust_game.efg\")\n",
+    "```"
    ]
   },
   {