python - 如何使 Sphinx 的继承关系图具有可读性？

Question

与此章的帖子类似，我看到 Sphinx 生成不可读的 graphviz 输出：

如何生成可读输出？

• 如果我添加什么都不会发生-Gfontsize=140
• 如果我告诉它使用neato而不是dot它会产生可读的输出，但图形不是树状的。

Answer 1

我从这个线程中找到了答案。在graphviz.py代码中，它们的图形大小的默认值为 8.0x12.0。如果你想让 Graphviz 确定你需要放入的大小，conf.py那么Sphinx graphviz 扩展使用你的空字符串而不是它的默认值：

inheritance_graph_attrs = dict(size='""')

此外，如果您遇到此问题，那么一旦您允许 Graphviz 确定大小，则图表可能太宽。您还需要属性rankdir="TB"，以便树从上到下而不是从左到右：

inheritance_graph_attrs = dict(rankdir="TB", size='""')