Allow recent Sphinx versions to be used for doc.

Author: anthony-tuininga

doc/README.md

@@ -1,18 +1,32 @@
-Sphinx 4.2 is used to generate the HTML for the python-oracledb documentation.
+Sphinx is used to generate the HTML for the python-oracledb documentation.
 
 The generated python-oracledb documentation is at https://python-oracledb.readthedocs.io/
 
 This directory contains the documentation source.  It is written using reST
-(re-Structured Text) format source files which are processed using Sphinx and
-turned into HTML, PDF or ePub documents. If you wish to build these yourself,
-you need to install Sphinx 4.2. Sphinx is available on many Linux distributions as a
-pre-built package. You can also install Sphinx 4.2 on all platforms using the Python
-package manager "pip".  To install Sphinx 4.2, run the following command:
-pip install Sphinx==4.2.0
+(re-Structured Text). The source files are processed using Sphinx and can be
+turned into HTML, PDF or ePub documentation.
+
+If you wish to build documentation yourself, install Sphinx.  It is available
+on many Linux distributions as a pre-built package. You can also install it
+using the Python package manager "pip", for example::
+
+    python -m pip install Sphinx
 
 For more information on Sphinx, please visit this page:
 
 http://www.sphinx-doc.org
 
-Once Sphinx 4.2 is installed, the supplied Makefile can be used to build the
-different targets.
+Once Sphinx is installed, the supplied Makefile can be used to build the
+different targets, for example to build the HTML documentation, run::
+
+    make
+
+To make ePub documentation, run::
+
+    make epub
+
+To make PDF documentation, run::
+
+    make pdf
+
+The program ``latexmk`` may be required by Sphinx to generate PDF output.

doc/src/_ext/table_with_summary.py

@@ -29,10 +29,12 @@
 # option on top of the regular "list-table" directive.
 #------------------------------------------------------------------------------
 
-import sphinx.writers.html5
+import sphinx
 from docutils.parsers.rst import directives
 from docutils.parsers.rst.directives import tables
 
+from packaging import version
+
 class ListTableWithSummary(tables.ListTable):
 
     option_spec = {'summary': directives.unchanged}
@@ -50,7 +52,10 @@ def run(self):
 class HTMLTranslator(sphinx.writers.html5.HTML5Translator):
 
     def visit_table(self, node):
-        self._table_row_index = 0
+        if version.parse(sphinx.__version__) > version.parse('4.2.0'):
+            self._table_row_indices = [0]
+        else:
+            self._table_row_index = 0
 
         atts = {}
         classes = [cls.strip(' \t\n') \