Skip to content

Add graphviz extension#678

Open
sadik-smd wants to merge 2 commits intoTexasInstruments:masterfrom
sadik-smd:buildroot-12.0
Open

Add graphviz extension#678
sadik-smd wants to merge 2 commits intoTexasInstruments:masterfrom
sadik-smd:buildroot-12.0

Conversation

@sadik-smd
Copy link
Copy Markdown
Contributor

@sadik-smd sadik-smd commented Apr 16, 2026

Summary

This PR adds a visual architecture diagram for the Buildroot-based
Linux embedded software stack targeting TI SoCs

Changes

conf.py

  • Added sphinxcontrib.graphviz to extensions list
  • Set graphviz_output_format = "svg" for crisp scalable output

Dockerfile

  • Added graphviz package

source/buildroot/Overview.rst

  • Added .. graphviz:: directive with full architecture diagram
  • Each component in the diagram is a clickable hyperlink that navigates directly to the corresponding source repository or documentation.

Preview for this architecture diagram can be found at-:
https://sadik-smd.github.io/processor-sdk-doc-fork/processor-sdk-buildroot-AM62X/esd/docs/master/buildroot/Overview.html#buildroot-architecture-for-ti-devices

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

Signed-off-by: Mahammed Sadik Shaik <[email protected]>
Add a architecture diagram for buildroot build system
using graphviz.

Signed-off-by: Mahammed Sadik Shaik <[email protected]>
@github-actions
Copy link
Copy Markdown

New warnings found with rstcheck:

source/buildroot/Overview.rst:53: (INFO/1) No directive entry for "graphviz" in module "docutils.parsers.rst.languages.en".
source/buildroot/Overview.rst:53: (ERROR/3) Unknown directive type "graphviz".

Comment on lines +53 to +56
.. graphviz::
:caption: Buildroot-based Linux Architecture for TI Devices

digraph buildroot_architecture {
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

May want to make this an external file considering it's length.

https://www.sphinx-doc.org/en/master/usage/extensions/graphviz.html#directive-graphviz

@StaticRocket
Copy link
Copy Markdown
Member

StaticRocket commented Apr 17, 2026

Please add the graphviz directives to the following config:

ignore_directives = ifconfig,tabs,tab,group-tab,code-tab

@StaticRocket
Copy link
Copy Markdown
Member

Also, you may want to try and restructure that graph a little, since it's very wide and will be dynamically scaled to match the aspect ratio of the screen viewing it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants