+ FEAT(sphinxext): +graphtik_plot_keywords sphinx-configuration ...

with a default value that suppresses grafting the title of a netop in the images,
to allow for using the `:name:` option of :rst:dir:`graphtik` directive.

Author: ankostis

docs/source/plotting.rst

@@ -318,6 +318,14 @@ Configurations
    is missing.
    If empty, ``{}`` assumed (library's default options).
 
+.. confval:: graphtik_plot_keywords
+
+   - type: `dict`
+   - default: ``{"title": None}``
+
+   Arguments or :func:`.build_pydot()` to apply when rendering plottables.
+   By default it suppresses the grafting the title of a netop in the images,
+   to allow for using the `:name:` option of :rst:dir:`graphtik` directive.
 
 .. Warning::
    Don't disable doctesting of *literal-blocks*, that is,

graphtik/base.py

@@ -217,7 +217,7 @@ def plot(
         show=False,
         jupyter_render: Union[None, Mapping, str] = None,
         **kws,
-    ):
+    ) -> "pydot.Dot":
         """
         Entry-point for plotting ready made operation graphs.
 

graphtik/sphinxext/__init__.py

@@ -392,9 +392,10 @@ def setup(app: Sphinx):
     )
     app.add_config_value("graphtik_default_graph_format", None, "html", [str, None])
     # TODO: impl sphinx-config --> graphtik-configs
-    app.add_config_value("graphtik_configurations", {}, "html", [cabc.Mapping])
-    # TODO: impl sphinx-config --> plot keywords
-    app.add_config_value("graphtik_plot_keywords", {}, "html", [cabc.Mapping])
+    app.add_config_value("graphtik_configurations   ", {}, "html", [cabc.Mapping])
+    app.add_config_value(
+        "graphtik_plot_keywords", {"title": None}, "html", [cabc.Mapping]
+    )
     app.add_config_value("graphtik_zoomable", True, "html", [bool])
     app.add_config_value(
         "graphtik_zoomable_options",

graphtik/sphinxext/_graphtikbuilder.py

@@ -57,9 +57,11 @@ def _globals_updated(self, code: extdoctest.TestCode, globs: dict):
                 globs, node["graphvar"], (code.filename, code.lineno)
             )
             if plottable:
-                dot: pydot.Dot = plottable if isinstance(
-                    plottable, pydot.Dot
-                ) else plottable.plot()
+                dot: pydot.Dot
+                if isinstance(plottable, pydot.Dot):
+                    dot = plottable
+                else:
+                    dot = plottable.plot(**self.config.graphtik_plot_keywords)
                 img_format = node["img_format"]
                 rel_img_path = self._render_dot_image(img_format, dot, node)
                 dot_str = (