Updates the output of sphinx and the generated config file

Author: dpshelio

ch04packaging/04documentation.ipynb

@@ -182,7 +182,7 @@
    "metadata": {},
    "source": [
     "```\n",
-    "Welcome to the Sphinx 3.3.0 quickstart utility.\n",
+    "Welcome to the Sphinx 4.2.0 quickstart utility.\n",
     "\n",
     "Please enter values for the following settings (just press Enter to\n",
     "accept a default value, if one is given in brackets).\n",
@@ -193,15 +193,41 @@
     "Either, you use a directory \"_build\" within the root path, or you separate\n",
     "\"source\" and \"build\" directories within the root path.\n",
     "> Separate source and build directories (y/n) [n]:\n",
+    "\n",
+    "The project name will occur in several places in the built documentation.\n",
+    "> Project name: Greetings\n",
+    "> Author name(s): James Hetherington\n",
+    "> Project release []: 0.1\n",
+    "\n",
+    "If the documents are to be written in a language other than English,\n",
+    "you can select a language here by its language code. Sphinx will then\n",
+    "translate text that it generates into that language.\n",
+    "\n",
+    "For a list of supported codes, see\n",
+    "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.\n",
+    "> Project language [en]:\n",
+    "\n",
+    "Creating file ./conf.py.\n",
+    "Creating file ./index.rst.\n",
+    "Creating file ./Makefile.\n",
+    "Creating file ./make.bat.\n",
+    "\n",
+    "Finished: An initial directory structure has been created.\n",
+    "\n",
+    "You should now populate your master file /tmp/index.rst and create other documentation\n",
+    "source files. Use the Makefile to build the docs, like so:\n",
+    "   make builder\n",
+    "where \"builder\" is one of the supported builders, e.g. html, latex or linkcheck.\n",
     "```"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "and then look at and adapt the generated config, a file called\n",
-    "conf.py in the root of the project. This contains the project's Sphinx configuration, as Python variables:"
+    "and then look at and adapt the generated config - a file called\n",
+    "`conf.py` in the root of the project - with, for example, the extensions we want to use.\n",
+    "This config file contains the project's Sphinx configuration, as Python variables:"
    ]
   },
   {
@@ -263,29 +289,31 @@
     "templates_path = ['_templates']\n",
     "source_suffix = '.rst'\n",
     "master_doc = 'index'\n",
-    "project = u'Greetings'\n",
-    "copyright = u'2014, James Hetherington'\n",
+    "project = 'Greetings'\n",
+    "copyright = '2014, James Hetherington'\n",
     "version = '0.1'\n",
     "release = '0.1'\n",
-    "exclude_patterns = ['_build']\n",
+    "exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']\n",
+    "html_theme = 'alabaster'\n",
+    "html_static_path = ['_static']\n",
     "pygments_style = 'sphinx'\n",
     "htmlhelp_basename = 'Greetingsdoc'\n",
     "latex_elements = {\n",
     "}\n",
     "\n",
     "latex_documents = [\n",
-    "  ('index', 'Greetings.tex', u'Greetings Documentation',\n",
-    "   u'James Hetherington', 'manual'),\n",
+    "  ('index', 'Greetings.tex', 'Greetings Documentation',\n",
+    "   'James Hetherington', 'manual'),\n",
     "]\n",
     "\n",
     "man_pages = [\n",
-    "    ('index', 'greetings', u'Greetings Documentation',\n",
-    "     [u'James Hetherington'], 1)\n",
+    "    ('index', 'greetings', 'Greetings Documentation',\n",
+    "     ['James Hetherington'], 1)\n",
     "]\n",
     "\n",
     "texinfo_documents = [\n",
     "  ('index', 'Greetings', u'Greetings Documentation',\n",
-    "   u'James Hetherington', 'Greetings', 'One line description of project.',\n",
+    "   'James Hetherington', 'Greetings', 'One line description of project.',\n",
     "   'Miscellaneous'),\n",
     "]"
    ]
@@ -302,7 +330,7 @@
    "metadata": {},
    "source": [
     "\n",
-    "Sphinx uses [RestructuredText](http://docutils.sourceforge.net/rst.html) another wiki markup format similar to Markdown.\n",
+    "Sphinx uses [RestructuredText](https://docutils.sourceforge.io/rst.html) another wiki markup format similar to Markdown.\n",
     "\n",
     "You define an \"index.rst\" file to contain any preamble text you want. The rest is autogenerated by `sphinx-quickstart`\n",
     "\n",