fixup! [wip]

conf.py

@@ -41,9 +41,8 @@ current_major_version = current_major_branch.replace('.0', '')
 # The minimal Sphinx version required to build the documentation.
 needs_sphinx = '3.0.0'
 
-# The default language in which the documentation is written. It is set to `None` because Sphinx
-# considers that no language means 'en'.
-language = None
+# The default language in which the documentation is written.
+language = 'en'
 
 # The suffix of source filenames.
 source_suffix = '.rst'

content/developer/reference/external_api.rst

@@ -598,8 +598,6 @@ which tends to be a huge amount.
                   asList(ids)
               )
           ))[0];
-          // count the number of fields fetched by default
-          record.size();
 
       .. code-tab:: go
 

extensions/odoo_theme/translator.py

@@ -2,7 +2,6 @@ from docutils import nodes
 from sphinx.locale import admonitionlabels
 from sphinx.writers.html5 import HTML5Translator
 
-
 # Translators inheritance chain:
 # Docutils Base HTML translator: https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/docutils/docutils/writers/_html_base.py
 # └── Docutils Polyglot html5 translator: https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/docutils/docutils/writers/html5_polyglot/__init__.py
@@ -109,7 +108,6 @@ class BootstrapTranslator(HTML5Translator):
     # admonition [name] -> alert-[name]
     # Enforce presence of [name]-title as class on the <p> containing the title
     def visit_admonition(self, node, name=''):
-        # type: (nodes.Node, unicode) -> None
         node_classes = ["alert"]
         if name:
             node_classes.append(ADMONITION_MAPPING[name])
@@ -121,7 +119,6 @@ class BootstrapTranslator(HTML5Translator):
     # overwritten
     # Appends alert-title class to <p> if parent is an Admonition.
     def visit_title(self, node):
-        # type: (nodes.Node) -> None
         if isinstance(node.parent, nodes.Admonition):
             self.body.append(self.starttag(node, 'p', CLASS='alert-title'))
         else:
@@ -147,18 +144,18 @@ class BootstrapTranslator(HTML5Translator):
     # overwritten
     # Ensure table class is present for tables
     def visit_table(self, node):
-        # type: (nodes.Node) -> None
-        self.generate_targets_for_table(node)
-
         # c/p of https://github.com/pydata/pydata-sphinx-theme/pull/509/files
         self._table_row_indices.append(0)
 
-        classes = [cls.strip(' \t\n')
-                   for cls in self.settings.table_style.split(',')]
+        atts = {}
+        classes = [cls.strip(' \t\n') for cls in self.settings.table_style.split(',')]
         classes.insert(0, "docutils")  # compat
         classes.insert(0, "table")  # compat
 
-        if 'align' in node:
-            classes.append('align-%s' % node['align'])
-        tag = self.starttag(node, 'table', CLASS=' '.join(classes))
+        # set align-default if align not specified to give a default style
+        classes.append('align-%s' % node.get('align', 'default'))
+
+        if 'width' in node:
+            atts['style'] = 'width: %s' % node['width']
+        tag = self.starttag(node, 'table', CLASS=' '.join(classes), **atts)
         self.body.append(tag)

requirements.txt

@@ -1,17 +1,15 @@
-docutils==0.16.0 ; python_version < '3.12'
-docutils==0.20.1 ; python_version >= '3.12'
-libsass==0.20.1 ; python_version < '3.12'
-libsass==0.22.0 ; python_version >= '3.12'
-pygments~=2.6.1 ; python_version < '3.12'
-pygments==2.17.2 ; python_version >= '3.12'
+docutils==0.20.1  # docutils<0.21,>=0.18.1
+sphinx==7.2.6
+pygments==2.17.2 # Pygments>=2.14
 pygments-csv-lexer~=0.1
 sphinx==4.3.2 ; python_version < '3.12'
-sphinx==7.2.6 ; python_version >= '3.12'
 sphinxcontrib-applehelp==1.0.4
 sphinxcontrib-devhelp==1.0.2
-sphinxcontrib-htmlhelp==2.0.1
-sphinxcontrib-serializinghtml==1.1.5 ; python_version < '3.12'
-sphinxcontrib-serializinghtml==1.1.10 ; python_version >= '3.12'
+sphinxcontrib-htmlhelp==2.0.1  # sphinxcontrib-htmlhelp>=2.0.0
+sphinxcontrib-serializinghtml==1.1.10 # sphinxcontrib-serializinghtml>=1.1.9
 sphinxcontrib-qthelp==1.0.3
-sphinx-tabs==3.2.0 ; python_version < '3.12'
-sphinx-tabs==3.4.5 ; python_version >= '3.12'  # docutils pinned to 0.18.0 in 3.4.4
+sphinx-tabs==3.4.5
+
+# C/p from odoo requirements
+libsass==0.20.1 ; python_version < '3.11'
+libsass==0.22.0 ; python_version >= '3.11'  # (Noble) Mostly to have a wheel package