在 Sphinx 中使用 graphviz 的图形中的内部参考?

问题描述

我正在尝试在我的 Sphinx 文档中使用 graphviz 创建一个图表。 我设法在图表中包含一个 href链接外部网页(此处为 https://jhermann.github.io/blog/python/documentation/2020/03/25/sphinx_ext_graphviz.html 的好例子)。 我现在想做同样的事情,但要引用我文档的另一页(使用类似 :ref:`another page of my documentation` 之类的内容而不是 href)。预期结果是:您单击图形的一个节点,它会打开相应的文档页面/部分。 这可能吗?有什么解决方法吗?

解决方法

我假设您在 HTML 中有效的 href 属性中放置的任何值也可以在 graphviz 中使用。尝试为其值添加相对路径,例如:

.. graphviz::
    :name: name

     digraph "my-digraph" {
         my [label="my-label",shape="component",href="relative/path/to/file.html"
             target="_blank"];
     }