OpenCyphal / pycyphal

Python implementation of the Cyphal protocol stack.
https://pycyphal.readthedocs.io/
MIT License
117 stars 105 forks source link

[docs] Class diagrams are scaled incorrectly #321

Open pavel-kirienko opened 5 months ago

pavel-kirienko commented 5 months ago

This is not reproducible on my local machine but is visible only on ReadTheDocs:

image

The difference is in the scale transform used in the generated SVG file. This is visible on the ReadTheDocs website:

image

This is on my local machine:

image

The obvious thing is that the graphviz (dot) version is different: the latest version in Ubuntu 22.04 is v2.43, which is reported in the generated SVG file, while on my machine (Manjaro) I have v9.0.

We should either set the scale explicitly or make ReadTheDocs use an up-to-date version of Graphviz. One way to do the latter is to grab the DEB package from the release page at https://gitlab.com/graphviz/graphviz/-/releases and install it using a pre-build job as documented in the readthedocs docs.