conf: include grahviz extension

Include graphviz extension for generating flow diagrams
and add graphviz output format as SVG.
Include the graphviz package to Dockerfile and rstcheck

Signed-off-by: Mahammed Sadik Shaik <s-sadik@ti.com>

Author: sadik-smd

.rstcheck.cfg

@@ -1,5 +1,5 @@
 [rstcheck]
-ignore_directives = ifconfig,tabs,tab,group-tab,code-tab
+ignore_directives = ifconfig,tabs,tab,group-tab,code-tab,graphviz
 # ignore the following languages because they require external compilers and
 # snippets in this repo depend on external code
 ignore_languages = c,cpp,c++

conf.py

@@ -39,6 +39,7 @@
     'sphinx.ext.todo',
     'sphinx.ext.mathjax',
     'sphinx.ext.ifconfig',
+    'sphinx.ext.graphviz',
     'sphinx_rtd_theme',
     'sphinx_tabs.tabs',
     'sphinx_copybutton'
@@ -253,6 +254,9 @@
 # Suppress warnings about excluded documents because every device gets a different toc tree
 suppress_warnings = ['toc.excluded']
 
+# Render graphviz diagrams as SVG so that hyperlinks in diagrams are clickable
+graphviz_output_format = 'svg'
+
 # -- Tag file loader ------------------------------------------------------
 
 FAMILY = os.environ.get("DEVFAMILY", "")

docker/Dockerfile

@@ -8,6 +8,7 @@ RUN apk add --no-cache \
 		diffutils \
 		dumb-init \
 		git \
+		graphviz \
 		make \
 		py3-pip \
 		ripgrep \