apidoc: apidoc_formatting: Fixed number references for figures and code listings (#2)

The explicit add_fignumber seems to be excessive - it creates
double Fig entries in rendered doc, and also add raw explicit
Listing string before code blocks.

The add_fignumber is now only called for code listings to
add number of listing to code block header

Signed-off-by: Grzegorz Latosinski <glatosinski@antmicro.com>

Author: glatosinski

sphinx_immaterial/apidoc/apidoc_formatting.py

@@ -61,11 +61,15 @@ def visit_caption(
         # This is needed to trigger mkdocs-material CSS rule `.highlight .filename`
         self.body.append('<div class="code-block-caption highlight">')
         # append a CSS class to trigger mkdocs-material theme's caption CSS style
-        attributes["class"] += " filename"
+        # create a span wrapping caption's content and (optionally) number
+        self.body.append('<span class="filename">')
+        # append a listing number
+        self.add_fignumber(node.parent)
+        self.body.append(self.starttag(node, "span", **attributes))
+        self.body.append("</span>")
     else:
         super_func(self, node)
-    self.add_fignumber(node.parent)
-    self.body.append(self.starttag(node, "span", **attributes))
+        self.body.append(self.starttag(node, "span", **attributes))
 
 
 @html_translator_mixin.override